Installation
CronManager offers two installation paths. Choose what fits your setup best.
🐳 Docker Compose
The easiest and fastest way to get started. Use the pre-built Docker Hub images with the ready-made Docker Compose file. Web UI and agent both run as containers — no PHP required on the host.
# Download example Docker Compose
curl -fsSL https://raw.githubusercontent.com/csoscd/cronmanager/main/docker/docker-compose-full.yml -o docker-compose.yml
# Edit the .env section, then:
docker compose up -d
docker-compose-full.yml on GitHub →
Requirements: Docker, Docker Compose v2
On first visit, a setup wizard guides you through creating the initial admin account.
🖥️ Agent on Host
Use this if the CronManager agent should run directly on the host instead of inside a Docker container. The web UI still runs as a Docker container. The setup script installs and configures everything automatically.
curl -fsSL https://raw.githubusercontent.com/csoscd/cronmanager/main/simple_debian_setup.sh | bash
Requirements: Debian/Ubuntu, Docker, Docker Compose v2, PHP 8.x on host
Configuration at a Glance
Agent Config
JSON config: bind address, HMAC secret, database credentials, logging, and notification settings (email and Telegram).
Web Config
JSON config: database connection, agent URL + HMAC secret, session settings, OIDC provider, and i18n defaults.
Full Documentation
Detailed README.md, TECHNICAL.md, and SECURITY.md are in the repository.
Open GitHub Repository →