Managing daemons

This guide runs a long-lived process under Supervisor, then checks its status and logs. Use daemons for processes that should run continuously, such as queue workers or websocket servers. For scheduled tasks, use cron instead.

Adding, modifying, removing, and controlling daemons requires root. Supervisor must be installed; you can install it as part of the first command with --install-supervisor.

1. Add a daemon

sudo abstrax daemon add queue-worker \
  --command="php artisan queue:work" \
  --directory=/var/www/myapp \
  --user=www-data \
  --processes=2 \
  --autostart \
  --autorestart=unexpected

If Supervisor is not installed yet:

sudo abstrax daemon add queue-worker \
  --command="php artisan queue:work" \
  --install-supervisor

Expected output:

Daemon queue-worker added.
  Config: /etc/supervisor/conf.d/abstrax-queue-worker.conf

The --command flag is required. If you leave it out, the command stops with --command is required.

2. Check the status

abstrax daemon status queue-worker

  Name:        queue-worker
  Status:      RUNNING
  Info:        pid 12345, uptime 0:10:00
  Config:      /etc/supervisor/conf.d/abstrax-queue-worker.conf

List all managed daemons:

abstrax daemon list

3. View the logs

abstrax daemon logs queue-worker
abstrax daemon logs queue-worker --lines=100 --follow

Use --stderr or --stdout to choose which log to read.

4. Control the process

sudo abstrax daemon restart queue-worker
sudo abstrax daemon stop queue-worker
sudo abstrax daemon start queue-worker

5. Modify the daemon

Change settings such as the number of processes; only the fields you pass are updated:

sudo abstrax daemon modify queue-worker --processes=4

6. Remove the daemon

By default the process is stopped before removal:

sudo abstrax daemon remove queue-worker --stop

To also delete its log files:

sudo abstrax daemon remove queue-worker --stop --delete-logs

Useful options on daemon add

Related

• Daemons command reference
• Managing cron jobs
• Services