Appa is a self-hosted, CLI-native deployment platform. Bring your own VPS, connect your domain, and deploy apps without writing Dockerfiles or configuring web servers.
Operator Machine Remote Server (VPS)
└─ Appa CLI ├─ Caddy Gateway
│ ├─ Appa API + Dashboard
SSH + Ansible + rsync ├─ BuildKit + Railpack
└──────────────────────────┼─ PostgreSQL
└─ Your containers
curl -fsSL https://appa.theolujay.dev/install.sh | sh
appa instance init my-server
appa instance set-host my-server root@203.0.113.10 -i ~/.ssh/id_ed25519
appa preflight my-server
appa setup my-serverOnce setup completes, open the dashboard URL to register your admin account.
See docs/user-guide.md for the full walkthrough — installation, instance management, project deployment, and CLI reference.
| Doc | For |
|---|---|
| User Guide | Setting up and using Appa day-to-day |
| Architecture | Design decisions, invariants, and data paths |
| Contributing | Development setup, API routes, coding conventions |
| Roadmap | Completed milestones and planned features |