Coolify Deployment Guide

team:orange Self-Hosting Infrastructure

Server Online • Build: 2025-11-26

🚀Coolify Dashboardcoolify.teamorange.dev 🦊GitLabgitlab.teamorange.dev 📚Coolify Docscoolify.io/docs

🚀 Neues Projekt deployen

Code zu GitLab pushen

git remote add origin ssh://git@gitlab.teamorange.dev:29418/teamorange/nerds/mein-projekt.git
git push -u origin main

DNS-Record erstellen

A-Record anlegen: mein-projekt.teamorange.dev → 157.90.19.138

Application in Coolify erstellen

Projects → Add Resource → Repository URL eintragen:

https://oauth2:<TOKEN>@gitlab.teamorange.dev/teamorange/nerds/mein-projekt.git

Domain & Port konfigurieren

Domain: https://mein-projekt.teamorange.dev
Port: 3000 (Next.js) • SSL wird automatisch generiert

🔑 HTTPS + Token (empfohlen)

Ein GitLab Access Token für alle Projekte. Einfachste Variante.

https://oauth2:<TOKEN>@gitlab.teamorange.dev/...

✓ Kein Key-Management
✓ Ein Token für alles
○ Token muss sicher gespeichert werden

🔐 SSH Deploy Key (sicherer)

Separater Key pro Projekt. Mehr Aufwand, mehr Kontrolle.

ssh://git@gitlab.teamorange.dev:29418/...

✓ Key pro Projekt isoliert
✓ Keine Token-Rotation nötig
○ Key in Coolify + GitLab einrichten

👥 Wer macht was?

Admin (einmalig)

Coolify Server aufsetzen
GitLab Access Token erstellen
API-Tokens für Mitarbeiter

Entwickler (pro Projekt)

Code zu GitLab pushen
DNS-Record anlegen
App in Coolify erstellen

Mitarbeiter (einmalig)

Coolify Account erhalten
Eigenen API-Token erstellen
MCP Server konfigurieren

🤖 Claude MCP Integration

Coolify direkt aus Claude steuern via coolify-mcp-server (npm).

1. API-Token erstellen:

Coolify Dashboard → Keys & Tokens → API tokens → Create New Token

2. Claude Desktop konfigurieren:

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "coolify-mcp-server"],
      "env": {
        "COOLIFY_TOKEN": "3|dein-token",
        "COOLIFY_BASE_URL": "http://157.90.19.138:8000"
      }
    }
  }
}

Befehle: coolify_list_applications, coolify_deploy, coolify_restart_app, ...

⚡ Next.js Konfiguration

Wichtig für Docker-Deployment in next.config.js:

const nextConfig = {
  output: 'standalone',  // Erforderlich für Coolify!
}

module.exports = nextConfig