Select your language

Installation

CronManager offers two installation paths. Choose what fits your setup best.

Recommended

🐳 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

🖥️ 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 →