A complete reference for managing services on Coolify v4 — covering MCP operations (with gap documentation), REST API, artisan tinker for operations the API can't do, Docker Compose configuration, Traefik domain routing, project/environment organization, health monitoring, deployment patterns, and the most common failure modes. Built from real production work at D1DX.
| Topic | What it covers |
|---|---|
| Method Decision Tree | When to use MCP vs REST API vs artisan tinker vs Livewire |
| MCP Operations | Full capability table, safe vs approval-required, documented gaps |
| REST API | Auth, service CRUD, restart, redeploy via direct curl calls |
| artisan tinker | Laravel model access via SSH for MCP gaps — move resources, rename services, direct DB queries |
| Livewire Internal API | How Coolify's browser UI works internally (and why it's not practical for automation) |
| Service Configuration | Docker Image / Compose / Git repo types, environment variable management |
| Domain Routing | Traefik label generation, custom domains, SSL via Let's Encrypt, Cloudflare DNS integration |
| Project Organization | Resource hierarchy (Project → Environment → Resource), moving resources between projects |
| Monitoring & Troubleshooting | Diagnostics-first approach, log access, common issue table (502, 504, OOM, SSL, stuck health checks) |
| Deployment Patterns | Rolling update, manual deploy, git-based webhook deploy |
| Critical Gotchas | 10 hard-won lessons — MCP gaps, memory limits, Traefik labels, Livewire checksums, volume persistence |
git clone https://github.com/D1DX/coolify-skill.git
cp -r coolify-skill ~/.claude/skills/coolifyOr as a git submodule:
git submodule add https://github.com/D1DX/coolify-skill.git path/to/skills/coolifyCopy SKILL.md into your agent's prompt or knowledge directory. The skill is structured markdown — works with any LLM agent that reads reference files.
coolify-skill/
├── SKILL.md — Main skill file (method decision tree, MCP, API, artisan tinker, gotchas)
├── README.md — This file
└── LICENSE — MIT
Distilled from operating a Coolify v4 instance on AWS EC2 Frankfurt — managing 16+ resources across 10 projects including n8n, Chatwoot, OpenClaw, WAHA, and custom services. Covers patterns learned through production deployments, incident response, MCP gap discovery, artisan tinker workarounds, and Traefik/DNS integration with Cloudflare.
Built by Daniel Rudaev at D1DX.
MIT License — Copyright (c) 2026 Daniel Rudaev @ D1DX