Self-Hosting
Self-hosted Crontinel works fully standalone. You do not need a crontinel.com account or API key. The dashboard, alerts, and all monitoring features run entirely on your server.
Note: The hosted product is app.crontinel.com. The app repo is private; self-hosting is an operator choice, not a Starter/Pro/Max entitlement claim. See Billing & Plans.
Requirements
| Component | Minimum version |
|---|---|
| PHP | 8.4 |
| PostgreSQL | 15 |
| Node.js | 20 |
| Redis | Required. The app uses Laravel Horizon, and .env.example sets QUEUE_CONNECTION=redis and CACHE_STORE=redis |
1. Clone and install
git clone https://github.com/crontinel/app.gitcd appcomposer install --no-dev --optimize-autoloadernpm ci && npm run build2. Environment
cp .env.example .envphp artisan key:generateSet these values in .env:
APP_URL=https://your-domain.comAPP_ENV=productionAPP_DEBUG=false
DB_CONNECTION=pgsqlDB_HOST=127.0.0.1DB_PORT=5432DB_DATABASE=crontinelDB_USERNAME=postgresDB_PASSWORD=DB_SSLMODE=require
REDIS_HOST=127.0.0.1
MAIL_MAILER=resendMAIL_FROM_ADDRESS=alerts@your-domain.com3. Database
php artisan migrate --force4. Permissions
chown -R www-data:www-data storage bootstrap/cachechmod -R 775 storage bootstrap/cache5. Web server
Caddy is the simplest option here. It provisions TLS certificates automatically via Let’s Encrypt with zero config. If you prefer Nginx, you’ll need to manage certificates yourself (see below).
Caddy
your-domain.com { root * /var/www/crontinel-app/public php_fastcgi unix//var/run/php/php8.5-fpm.sock file_server}Nginx
server { listen 443 ssl; server_name your-domain.com;
ssl_certificate /etc/ssl/certs/your-domain.com.pem; ssl_certificate_key /etc/ssl/private/your-domain.com.key;
root /var/www/crontinel-app/public; index index.php;
location / { try_files $uri $uri/ /index.php?$query_string; }
location ~ \.php$ { fastcgi_pass unix:/var/run/php/php8.5-fpm.sock; fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; include fastcgi_params; }}Replace the ssl_certificate and ssl_certificate_key paths with your actual cert and key. If you use Certbot, the paths are typically /etc/letsencrypt/live/your-domain.com/fullchain.pem and privkey.pem.
6. Queue workers
Crontinel needs a persistent queue worker to process ping events, alerts, and Horizon data.
Create a Supervisor config at /etc/supervisor/conf.d/crontinel.conf:
[program:crontinel-worker]command=php /var/www/crontinel-app/artisan queue:work redis --sleep=3 --tries=3 --max-time=3600directory=/var/www/crontinel-appuser=www-datanumprocs=2autostart=trueautorestart=truestopasgroup=truekillasgroup=truestdout_logfile=/var/log/crontinel/worker.log
[program:crontinel-alerts]command=php /var/www/crontinel-app/artisan queue:work cron-alerts --queue=cron-alerts --sleep=3 --max-time=3600directory=/var/www/crontinel-appuser=www-datanumprocs=1autostart=trueautorestart=truestopasgroup=truekillasgroup=truestdout_logfile=/var/log/crontinel/alerts.logCron run, missed-run and quality alerts are dispatched on the cron-alerts connection and queue, a database queue defined in config/queue.php. A worker on the default Redis connection does not process them, so run the second program. AI investigations and output grading use a separate ai-investigations database connection and queue; run a worker for it too if you use those features.
Then:
supervisorctl rereadsupervisorctl updatesupervisorctl start crontinel-worker:*7. Scheduler
Add the Laravel scheduler to cron for www-data:
* * * * * cd /var/www/crontinel-app && php artisan schedule:run >> /dev/null 2>&18. Verify
php artisan queue:monitor redis:defaultphp artisan horizon:statusCheck /health returns 200 — that endpoint is always unauthenticated.
Access the dashboard
After install, sign in and open /dashboard on your domain. Data appears once the scheduler and queue workers are running.
Horizon access
Access to /horizon is limited by the viewHorizon gate in the app’s HorizonServiceProvider. It allows signed-in users whose email is in ADMIN_EMAILS, a comma-separated list:
ADMIN_EMAILS=admin@yourcompany.com,ops@yourcompany.comIf ADMIN_EMAILS is not set, nobody can open Horizon outside the local environment. This is separate from the Laravel package’s dashboard, which uses the crontinel.view gate.
Upgrades
git pullcomposer install --no-dev --optimize-autoloadernpm ci && npm run buildphp artisan migrate --forcephp artisan config:cachephp artisan route:cachephp artisan view:cachesupervisorctl restart crontinel-worker:*