app-hyggecraftery/COOLIFY_APP_KONFIGURIEREN.md

⚙️ Coolify Application konfigurieren

📋 Schritt-für-Schritt Anleitung

Schritt 1: Application öffnen

1. Gehe zu Coolify Dashboard
2. Öffne deine neue Application (die du gerade erstellt hast)
3. Klicke auf "Settings" oder "Configuration"

---

Schritt 2: Source konfigurieren

1. Gehe zu "Source" oder "Repository" Tab
2. Source Type: Wähle "Private Repository (with GitHub App)"
3. GitHub App: Wähle "hyggecraftery-app" aus der Dropdown-Liste
   • Das ist die GitHub App, die du vorhin erstellt hast
4. Repository:
   • Entweder: Wähle Timborimbo/hyggecraftery_APP aus der Dropdown-Liste
   • ODER: Gib manuell ein: https://github.com/Timborimbo/hyggecraftery_APP.git
5. Branch: main
6. Klicke auf "Save"

---

Schritt 3: Build Pack konfigurieren

1. Gehe zu "Build Pack" oder "Build" Tab
2. Build Pack: Wähle "Dockerfile"
3. Dockerfile Path: Dockerfile (Standard)
4. Port: 80
5. Klicke auf "Save"

---

Schritt 4: Prüfen ob Repository verfügbar ist

Falls das Repository nicht in der Dropdown-Liste erscheint:

1. Gehe zurück zu GitHub App Settings (nicht Application Settings!)
2. Klicke auf "Update Repositories" (Button mit externem Link)
3. Oder: Gehe direkt zu GitHub → Settings → GitHub Apps → hyggecraftery-app
4. Stelle sicher, dass hyggecraftery_APP Repository ausgewählt ist
5. Gehe zurück zu Application Settings
6. Klicke auf "Refresh" oder "Sync"

---

Schritt 5: Deployen

1. Gehe zurück zu deiner Application
2. Klicke auf "Deploy" oder "Redeploy"
3. Coolify wird jetzt:
   • Code von GitHub holen (über die GitHub App)
   • Dockerfile bauen
   • App deployen

---

🔍 Was passiert technisch?

1. Coolify verbindet sich mit GitHub:

   • Über die GitHub App (hyggecraftery-app)
   • Mit den Credentials (App Id, Installation Id, Private Key)

2. Coolify holt den Code:

   • Von: https://github.com/Timborimbo/hyggecraftery_APP.git
   • Branch: main

3. Coolify baut das Docker Image:

   • Verwendet das Dockerfile aus dem Repository
   • Baut die Flutter Web App

4. Coolify deployed die App:

   • Startet den Container
   • Macht die App verfügbar unter der konfigurierten Domain

---

✅ Checkliste

• Application erstellt
• Source Type = "Private Repository (with GitHub App)"
• GitHub App = "hyggecraftery-app"
• Repository = Timborimbo/hyggecraftery_APP oder URL
• Branch = main
• Build Pack = "Dockerfile"
• Dockerfile Path = Dockerfile
• Port = 80
• Repository in GitHub App konfiguriert
• Deploy gestartet

---

🆘 Troubleshooting

Problem: Repository erscheint nicht in der Liste

Lösung:

1. Gehe zu GitHub App Settings in Coolify
2. Klicke auf "Update Repositories"
3. Prüfe in GitHub: Repository → Settings → GitHub Apps → hyggecraftery-app
4. Stelle sicher, dass das Repository ausgewählt ist

Problem: "Repository not found"

Lösung:

• Prüfe die Repository-URL (muss genau sein)
• Prüfe, ob das Repository in der GitHub App konfiguriert ist
• Prüfe, ob die GitHub App Installation aktiv ist

Problem: "Permission denied"

Lösung:

• Prüfe die GitHub App Permissions
• Stelle sicher, dass die App Zugriff auf das Repository hat

---

📋 Zusammenfassung

Coolify weiß, was es nutzen soll, weil du es konfigurierst:

1. GitHub App → Verbindung zu GitHub
2. Repository → Welches Repository
3. Branch → Welcher Branch
4. Build Pack → Wie gebaut wird (Dockerfile)
5. Port → Auf welchem Port die App läuft

Alles wird in den Application Settings konfiguriert!