deploy-coolify-cloud

Deploy and update docker-compose services on Coolify Cloud (app.coolify.io) from evidence, not memory. The coolify CLI can start/stop/inspect/deploy but cannot create or edit compose services — that is raw REST API, with a few undocumented rules this skill pins down. Every contract here was verified against live Coolify Cloud behavior and the CLI/OpenAPI surface.

Use this skill when

• deploying a new docker-compose service to a server managed by Coolify Cloud
• changing a running service's compose (image, ports, env, volumes, healthcheck)
• setting up automatic updates — poll an upstream image, redeploy + restart on a new version
• a deploy "succeeded" in the API but the container isn't up, and you need to know why
• wiring the prerequisites — project / environment / server UUIDs — before a service create
• first-time token/CLI setup on this machine (get, store, persist the API token)
• migrating a service between a self-hosted Coolify and Coolify Cloud
• verifying on the box that a Coolify deploy actually started, not just got queued

Do NOT use this skill when