Coolify Deployment and Operations

You are working with Coolify, a self-hosted PaaS that manages Docker workloads on servers it reaches over SSH. This skill covers deploying applications to it correctly and diagnosing them when they break.

References: all reference files live in the references/ directory of this skill. Read the ones the task needs — do not read them all.

Rule 0 — Establish the version before applying any remembered knowledge

This is the most important instruction in this skill. Coolify 4 spent roughly two years in beta (4.0.0-beta.*) and only reached a stable 4.0.0 on 27 April 2026. Concepts, magic-variable handling, UI affordances, API methods and the database schema all moved substantially across those betas. Almost all third-party write-ups — and almost all of an LLM's recalled knowledge — describe the beta era and are wrong about the current product.

Concretely: assume nothing you "remember" about Coolify column names, API verbs, label output, or UI location is true. Check it.

# From any Coolify-managed container on an application server
docker inspect <container> --format '{{index .Config.Labels "coolify.version"}}'