Manage your entire Coolify infrastructure from Claude Code. Deploy apps, control databases, manage services, handle environment variables, and troubleshoot — all through natural language.
git clone https://github.com/dnh33/coolify-skill.git ~/.claude/skills/coolifyDownload this repo and drop the folder into ~/.claude/skills/coolify. That's it — Claude Code auto-discovers skills on next session start.
Two environment variables are needed for API access:
export COOLIFY_API_URL="https://coolify.example.com"
export COOLIFY_API_TOKEN="your-bearer-token-here"Get your token: Coolify Dashboard → Keys & Tokens → API tokens → Create with
*permission for full access.
This skill gives Claude Code deep knowledge of Coolify's API, architecture, and operations:
| Capability | Examples |
|---|---|
| Deploy & control | Start, stop, restart applications, databases, and services |
| Create resources | Spin up apps from Git repos, Docker images, Dockerfiles, or Compose |
| Environment vars | List, set, bulk-update, and delete env vars |
| Monitor | Deployment status, application logs, resource overview |
| Database ops | Create 8 DB types, configure automated S3 backups |
| Server management | Multi-server architecture, proxy config, Cloudflare tunnels |
| Troubleshoot | Diagnose 502s, SSL issues, connection problems, stuck services |
"List all my Coolify applications"
"Deploy the app with UUID abc123"
"Restart the PostgreSQL database"
"Set NODE_ENV to production on my-app"
"What's running on my Hetzner server?"
"Create a new Redis database in staging"
"Show me the deployment logs"
"Why am I getting a 502 on my app?"
coolify-skill/
├── SKILL.md # Core skill — auto-loaded on trigger
├── references/
│ ├── api-endpoints.md # Complete API reference (80+ endpoints)
│ └── server-management.md # Servers, proxies, tunnels, backups, troubleshooting
└── scripts/
└── coolify-api.sh # Standalone CLI helper script
The skill uses progressive disclosure — only loads what's needed:
- Always in context — name + description for trigger matching (~100 words)
- On trigger — SKILL.md with core workflows and API patterns
- On demand — reference files when deeper detail is needed
| Category | Endpoints | Operations |
|---|---|---|
| Applications | 15 | CRUD, deploy, restart, stop, logs, env vars |
| Databases | 16 | Create (8 types), CRUD, backups, start/stop |
| Services | 11 | CRUD, env vars, start/restart/stop |
| Servers | 8 | CRUD, validate, list domains/resources |
| Projects | 7 | CRUD, environments |
| Deployments | 5 | Trigger, list, cancel |
| Security | 5 | SSH key management |
| GitHub Apps | 6 | CRUD, list repos/branches |
| Hetzner | 5 | Locations, server types, images, create |
| Cloud Tokens | 5 | CRUD, validate |
| System | 4 | Health, version, enable/disable API |
scripts/coolify-api.sh also works standalone outside Claude Code:
export COOLIFY_API_URL="https://coolify.example.com"
export COOLIFY_API_TOKEN="your-token"
./scripts/coolify-api.sh status # Overview of all resources
./scripts/coolify-api.sh list applications # List all apps
./scripts/coolify-api.sh deploy abc123 # Deploy an app
./scripts/coolify-api.sh restart services xyz456
./scripts/coolify-api.sh logs abc123
./scripts/coolify-api.sh set-env applications abc123 NODE_ENV production
./scripts/coolify-api.sh envs applications abc123- Claude Code CLI
- A running Coolify instance (self-hosted or Coolify Cloud)
- API token with appropriate permissions
Sourced directly from:
- Coolify official docs (including LLM-optimized
/docs/llms-full.txt) - Coolify API source code (
routes/api.php) - Coolify CLI
Daniel Hjermitslev — @dnh33