EN Home

Welcome to the Procodile wiki.

Procodile is a Procfile-based process manager for long-running applications.

• It can run in the foreground or in the background.
• It can start, stop, restart, and monitor multiple processes.
• It can manage logs and PID files.
• It can respawn failed processes.
• It supports port allocation and proxy configuration.

In addition to the functionality described above, this documentation also covers the new features only available in the current Crystal implementation, including scheduled processes, runtime issues, improved reload semantics, environment file (.env) support, and the current behavior of the CLI commands.

The current implementation also fixes many issues from the original Ruby version and handles a wide range of edge cases more carefully, making Procodile more robust overall.

If you are new to Procodile, start with Getting Started.

Core Guides

• Getting Started
• Configuration
• CLI Reference
• Scheduled Processes
• Runtime Issues and Errors
• Environment Files
• Deployments
• Questions

Additional Pages

• Restart Modes
• Managing PID Files
• Ports & Proxy
• Process Tagging