Where should individual program configuration files be placed on Linux?

On Debian/Ubuntu systems, individual program files belong in /etc/supervisor/conf.d/*.conf. On CentOS/RHEL/Rocky Linux, they typically reside in /etc/supervisord.d/*.ini or *.conf, included via the main supervisord.conf [include] directive.

How do I apply configuration changes without restarting all services?

Execute 'supervisorctl reread' to detect newly added or edited configuration blocks, then run 'supervisorctl update'. This gracefully applies changes only to updated programs while leaving healthy running processes untouched.

How do I run Python virtual environments (venv) or Node.js version managers in Supervisord?

Supervisord does not load user shell profiles (.bashrc or .zshrc). Specify absolute paths directly to the virtualenv binary, for example: command=/home/appuser/venv/bin/gunicorn app:app or command=/home/appuser/.nvm/versions/node/v20.0.0/bin/node server.js.

What is the difference between autorestart=true and autorestart=unexpected?

Setting 'autorestart=true' restarts the process unconditionally whenever it terminates, even after a clean zero-status exit. Setting 'autorestart=unexpected' only restarts the process if it exits with an unlisted status code not defined in 'exitcodes' (default: 0 and 2).

How do I set environment variables for a Supervisord program?

Use the 'environment=' directive with comma-delimited key-value pairs, like: environment=NODE_ENV="production",PORT="3000",DATABASE_URL="postgres://...". Values containing commas or spaces must be enclosed in double quotes.

Linux Supervisord (supervisord.conf) Program Generator

Zero-Zombie POSIX

Generate Supervisord program configuration blocks with auto-restart, process counts, log redirection, environment variables, and user privileges.

Presets:

Program Binary & Execution

Program Name *

System User

Execution Command *

Working Directory

File Creation Mask (umask)

Process Cluster & Concurrency

Instances: 4

Process Instances (numprocs)

Process Name Pattern

Lifecycle & Auto-Restart Policies

Auto Restart Policy

Start Threshold (secs)

Max Start Retries

Auto Start on Boot

POSIX Signals & Process Tree Containment

Stop Signal

Graceful Timeout (secs)

stopasgroup=true

Propagates stopsignal to all child subprocess forks. Prevents orphaned workers.

killasgroup=true

Sends SIGKILL to the entire process group if graceful timeout expires.

Logging & Stream Redirection

Standard Output Logfile

stdout_logfile_maxbytes

stdout_logfile_backups

Redirect stderr to stdout

Environment Variables

KEY="value"

Line breaks will automatically be formatted into standard comma-separated Supervisord syntax.

Directives: 26•Procs: 4•Signal: SIGQUIT

User: www-data

; ==============================================================================
; Supervisord Program Configuration: laravel-worker
; Generated 100% Client-Side Private on ToolsAA
; Path: /etc/supervisor/conf.d/laravel-worker.conf (Ubuntu/Debian)
;   or: /etc/supervisord.d/laravel-worker.ini (CentOS/RHEL/Rocky)
; ==============================================================================

[program:laravel-worker]
command=php /var/www/laravel/artisan queue:work redis --sleep=3 --tries=3 --max-time=3600
process_name=%(program_name)s_%(process_num)02d
numprocs=4
directory=/var/www/laravel
user=www-data
umask=022
priority=999
autostart=true
autorestart=true
startsecs=1
startretries=3
stopsignal=QUIT
stopwaitsecs=3600
stopasgroup=true
killasgroup=true
redirect_stderr=true
stdout_logfile=/var/log/supervisor/laravel-worker.log
stdout_logfile_maxbytes=50MB
stdout_logfile_backups=5
environment=APP_ENV="production",CACHE_DRIVER="redis"

29 lines•944 chars•944 B

program• POSIX Synthesized

Cluster Concurrency

4 Processes

Load-balanced parallel execution pool

Zombie Protection

100% Contained

stopasgroup & killasgroup both active

Log Rotation Limit

50MB × 5

Capped disk consumption with automatic log rotation

100% In-Browser Deterministic INI Synthesis

Zero server uploads or background tracking. Process configurations, environment keys, and security masks are parsed and generated completely in your browser memory.

Safe Process Tree Containment & Zombie Prevention

Pre-configured with stopasgroup and killasgroup flags to ensure subprocesses (e.g., Celery, Gunicorn, Node child processes) are terminated cleanly without leaving orphaned zombies.

Multi-Platform Production Compatibility

Tailored for Ubuntu/Debian /etc/supervisor/conf.d/, RHEL/CentOS /etc/supervisord.d/, Docker container multi-process entrypoints, and systemd units.