Configuration
Configuration
Overview of pm3.toml configuration file structure.
pm3 uses a single pm3.toml file to define your processes. Each top-level TOML table is a process, and the table name becomes the process name.
[web]
command = "node server.js"
cwd = "./frontend"
env = { PORT = "3000" }
[api]
command = "python app.py"
depends_on = ["web"]Structure
- Each
[name]table defines a process. - Only
commandis required — everything else has sensible defaults. - Process names must not contain
/,\, or...
Sections
Process Options
All per-process fields: command, cwd, env, restart policy, signals, hooks, and more.
Health Checks
HTTP, HTTPS, and TCP health checks to monitor process readiness.
File Watching
Auto-restart processes when source files change.
Cron Restarts
Schedule periodic process restarts with cron expressions.
Memory Limits
Auto-restart processes that exceed a memory threshold.
Environments
Environment-specific configuration overrides.