Discover Cipi

One command.
Full production stack.

Cipi installs Nginx, PHP, MariaDB, Redis, SSL, Fail2ban, UFW, Supervisor, and Deployer on any Ubuntu VPS. In about ten minutes. For free.

root@ubuntu ~ install
02 — ALERTS & NOTIFICATIONS

Your server never stays silent

Configure SMTP once and Cipi becomes your security watchdog. Email alerts fire on deploy failures, backup errors, SSH intrusions, privilege escalations, key changes, and app lifecycle events. You sleep, Cipi watches.

  • Deploy failures & backup errors
  • SSH login, sudo/su elevation, Fail2ban bans
  • SSH key add/remove/rename tracking
  • App create/edit/delete lifecycle events
  • All events logged to /var/log/cipi/events.log
Deep dive
cipi ~ alerts
03 — GIT PROVIDER

Connect GitHub or GitLab

Add your personal access token and Cipi auto-creates deploy keys and webhooks on every app create. No manual repo settings.

GitHub GitLab Self-hosted GitLab
  • Auto deploy key injection
  • Auto webhook creation
  • Custom GitLab URL support
Deep dive
cipi ~ git
04 — CIPI AGENT

Your app, connected

A Laravel package that unlocks webhook deploys, health checks, MCP server for AI debugging, and GDPR-safe database anonymization. One require, zero config.

  • Auto-discovers, no config needed
  • Webhook + Health + MCP + Anonymizer
  • .env variables auto-injected by Cipi
Deep dive
myapp ~ composer
05 — APPS VIA CLI

Create. Deploy. Done.

Every app gets its own Linux user, database, Nginx vhost, PHP-FPM pool, workers, and zero-downtime Deployer releases. Full isolation.

Isolated users Zero-downtime Auto SSL
Deep dive
cipi ~ apps
06 — REST API

Everything is an endpoint

Every CLI command is also a REST API call. Build dashboards, CI/CD integrations, or custom tooling. There is also an MCP (Model Context Protocol) to interface with the APIs. Token-based auth, JSON responses.

  • Create, deploy, manage apps via HTTP
  • Fine-grained token abilities
  • Async jobs with status polling
Deep dive
~ api calls
07 — AUTO-DEPLOY

git push = deployed

Push to your branch, the webhook fires, Cipi deploys in the background. Signature-verified, zero-downtime, instant HTTP response. No CI/CD pipeline needed.

  • HMAC signature verification
  • Background deploy (no HTTP timeout)
  • Branch filtering support
Deep dive
~ webhook deploy
08 — SECURITY ALERTS

Your server talks back

Get alerted on SSH intrusion attempts, blocked IPs, deploy failures, and service restarts. Cipi watches, you sleep.

  • Fail2ban ban/unban events
  • Deploy success & rollback alerts
  • Configurable via SMTP or Telegram
Deep dive
~ security events
09 — HEALTH CHECK

Real-time app vitals

A JSON endpoint that reports PHP version, database connectivity, disk usage, queue health, and scheduler status. Perfect for UptimeRobot, Pingdom, or custom monitors.

Deep dive
~ health check
10 — MCP SERVER

Your AI talks to production

Connect Cursor, VS Code, or Claude Desktop to your live app via MCP. Six tools: health, app_info, logs, db_query, artisan, and deploy. Ask questions in natural language. Read logs, run SQL, clear cache, trigger deploys — no SSH needed.

health app_info logs db_query artisan deploy
  • SQL queries with ASCII table results (capped at 100 rows)
  • Log filtering by type, severity, and keyword search
  • Destructive DDL blocked (DROP, TRUNCATE, GRANT)
  • Works over HTTPS only — no SSH access required
Deep dive
AI + MCP ~ live conversation
11 — ANONYMIZATION

GDPR-safe data exports

Define anonymization rules per table and column. Get a full database dump with fake data replacing PII. Real structure, no real personal data.

Deep dive
myapp ~ anonymize
12 — DB BACKUP

Quick dumps, one command

One command to backup a database. Schedule it in cron, get a compressed dump. No manual mysqldump, no hassle.

Deep dive
cipi ~ backup
13 — DB RESTORE

Restore from backup

Pick a backup, restore it. One command, no manual SQL imports. Your database is back to the exact state you need.

Deep dive
cipi ~ restore
14 — S3 BACKUP

Full app backup to the cloud

Code, database, .env, storage — everything encrypted and shipped to any S3-compatible bucket. Schedule it, forget it, sleep well.

AWS S3 DO Spaces MinIO Backblaze
Deep dive
cipi ~ s3 backup
15 — SYNC

Clone server A → B

Transfer apps, databases, configs, and SSL certificates to a replica server in one encrypted SSH transfer. Migration or disaster recovery, one command.

  • AES-256 encrypted archive transfer
  • Selective app sync or full server
  • Include DB dumps and storage files
Deep dive
cipi ~ sync
16 — SECURITY

Hardened by default

SSH key-only auth, Fail2ban, UFW firewall, unattended security upgrades, AES-256 vault for all credentials, GDPR-compliant log retention, and isolated Linux users for every app. Security isn't an add-on. It's the architecture.

SSH hardening Fail2ban UFW AES-256 vault GDPR logs
Deep dive
cipi ~ security

Ready to ship?

One command to install. One command to deploy. Zero lock-in, forever free, MIT licensed.

Read the Docs Star on GitHub
$ wget -O - https://cipi.sh/setup.sh | bash