Documentation / Management Commands
Documentation
- Getting Started
- Installation
- Frontend Setup
- Theming
- User Model
- Authorization
- Configuration
- Routes
- Tickets
- Public Tickets
- Bulk Actions
- Conversations
- Statuses & Priorities
- SLAs & Escalation
- Macros
- Automation Types
- Custom Ticket Actions
- Automations
- Newsletters
- Workflows
- Followers
- Satisfaction Ratings
- Collaboration
- Keyboard Shortcuts
- Events
- Scheduling
- Notifications
- Inbound Email
- Importing Data
- Single Sign-On
- REST API
- Management Commands
- Mobile SDKs
- Contributing
- Plugin Development
- Compare
Management Commands
Each backend framework includes CLI commands for operations, maintenance, and setup.
Management commands work regardless of the UI setting. All commands listed below function normally in headless mode.
Setup
install
Run the interactive setup wizard to configure Escalated.
| Framework | Command |
|---|---|
| Laravel | php artisan escalated:install |
| Django | python manage.py install |
What it does:
- Runs pending database migrations
- Seeds default permissions and roles
- Creates a default "General" department
- Creates a default SLA policy
- Optionally creates a superuser (interactive mode)
- Prints URLs for admin panel, agent dashboard, customer portal, and API
Use --no-input for non-interactive mode (CI/CD).
Plugin Management
plugin
Manage installed plugins from the command line.
| Framework | Command |
|---|---|
| Django | python manage.py plugin <subcommand> |
| Laravel | php artisan escalated:plugin <subcommand> |
Subcommands:
| Subcommand | Description |
|---|---|
list |
Show all installed plugins with status |
activate <slug> |
Activate a plugin |
deactivate <slug> |
Deactivate a plugin |
Scheduled Tasks
These commands should be run on a cron schedule.
check-sla
Check all open tickets for SLA breaches and send warnings.
| Framework | Command |
|---|---|
| Laravel | php artisan escalated:check-sla |
| Django | python manage.py check_sla |
| Rails | bundle exec rake escalated:check_sla |
Options: --warning-threshold <minutes> (default: 30)
evaluate-escalations
Evaluate escalation rules against open tickets and trigger actions.
| Framework | Command |
|---|---|
| Laravel | php artisan escalated:evaluate-escalations |
| Django | python manage.py evaluate_escalations |
run-automations
Execute time-based automation rules.
| Framework | Command |
|---|---|
| Laravel | php artisan escalated:run-automations |
| Django | python manage.py run_automations |
close-resolved
Auto-close tickets that have been in "resolved" status for a configurable number of days.
| Framework | Command |
|---|---|
| Laravel | php artisan escalated:close-resolved |
| Django | python manage.py close_resolved |
Options: --days <number> (default: 7), --dry-run
poll-imap
Poll an IMAP mailbox for inbound emails and create/update tickets.
| Framework | Command |
|---|---|
| Laravel | php artisan escalated:poll-imap |
| Django | python manage.py poll_imap |
Maintenance
purge-expired-data
Clean up expired tokens, old webhook deliveries, and stale import jobs.
| Framework | Command |
|---|---|
| Laravel | php artisan escalated:purge-expired-data |
| Django | python manage.py purge_expired_data |
Options: --days <number> (default: 30), --dry-run
Purges:
- Expired API tokens
- Webhook delivery records older than N days
- Failed/abandoned import jobs older than 7 days
purge-activities
Delete old ticket activity log entries beyond a retention period.
| Framework | Command |
|---|---|
| Laravel | php artisan escalated:purge-activities |
| Django | python manage.py purge_activities |
Options: --days <number> (default: 90), --dry-run
seed-permissions
Initialize or refresh the default permission set and system roles. Safe to run multiple times (idempotent).
| Framework | Command |
|---|---|
| Django | python manage.py seed_permissions |
Data Import
import
Import tickets and data from external platforms.
| Framework | Command |
|---|---|
| Laravel | php artisan escalated:import |
| Django | python manage.py escalated_import |
Supported platforms: Zendesk, Freshdesk, Intercom, Help Scout. See Importing Data for details.