Step 1: Add a new resource
- From the Coolify dashboard, click + New Resource.
- Choose your deployment source:
- Public/Private Git Repository (GitHub, GitLab, Bitbucket, or a generic Git URL)
- Docker Image (pull directly from Docker Hub or a private registry)
- Docker Compose (paste or link an existing compose file)
Step 2: Configure the build
- For a Git-based deploy, Coolify auto-detects the build pack (Dockerfile, Nixpacks, or static) — select Dockerfile if your repo already has one.
- For a Docker Compose deploy, paste your
docker-compose.ymlcontent directly, or point to the file’s path in your repository.
Step 3: Set the destination server and network
- Choose which connected server the app should deploy to.
- Assign it to a project/environment for organizational clarity (e.g., “production,” “staging”).
Step 4: Deploy
- Click Deploy. Coolify builds the image, pulls dependencies, and starts the container(s).
- Watch the real-time build logs in the dashboard to catch errors early.
- Once deployed, Coolify assigns an internal port mapping — you’ll connect this to a domain in the next step (see the domain/SSL guide below).
⚙️ Managing Deployments
- Redeploy manually anytime from the resource’s page, or configure a webhook so pushes to your Git branch trigger auto-deployment.
- View logs, resource usage, and container terminal access directly from the app’s dashboard page — no need to SSH in separately for routine checks.
