app-hyggecraftery/COOLIFY_GITHUB_APP.md

🔗 Coolify mit GitHub App konfigurieren

✅ GitHub App erstellt

Du hast bereits eine GitHub App erstellt:

• App Name: hyggecraftery-app
• App Id: 2575909
• Installation Id: 102151662

---

📋 Schritt 1: Application konfigurieren

1.1 Application öffnen

1. Gehe zu Coolify Dashboard
2. Öffne deine Application: APP_hgyyecraftery
3. Klicke auf "Settings" oder "Configuration"

1.2 Source konfigurieren

1. Gehe zu "Source" oder "Repository"
2. Source Type: Wähle "Private Repository (with GitHub App)"
3. GitHub App: Wähle "hyggecraftery-app" (deine erstellte App)
4. Repository URL: https://github.com/Timborimbo/hyggecraftery_APP.git
   • ODER: Wähle das Repository aus der Dropdown-Liste (falls verfügbar)
5. Branch: main
6. Speichern

---

📋 Schritt 2: Repository zu GitHub App hinzufügen (falls nötig)

Falls das Repository nicht in der Dropdown-Liste erscheint:

1. Gehe zurück zu GitHub App Settings (wo du die App erstellt hast)
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 Coolify und klicke auf "Sync Name" oder "Update Repositories"

---

📋 Schritt 3: 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

---

✅ Vorteile der GitHub App

• ✅ Sicherer als Deploy Keys (bessere Berechtigungen)
• ✅ Einfacher (kein manuelles Hinzufügen von Keys)
• ✅ Mehrere Repositories möglich
• ✅ Automatische Updates bei Repository-Änderungen

---

🔍 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, ob das Repository der App zugewiesen ist:
   • GitHub → Settings → GitHub Apps → hyggecraftery-app → Repository access

Problem: "Repository not found" oder "Permission denied"

Lösung:

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

Problem: Code wird nicht aktualisiert

Lösung:

• Pushe neue Änderungen zu GitHub:

  git add .
  git commit -m "Update"
  git push
  

• Dann in Coolify: "Redeploy" klicken

---

✅ Checkliste

• GitHub App erstellt: hyggecraftery-app ✅
• Application: Source Type = "Private Repository (with GitHub App)"
• Application: GitHub App = "hyggecraftery-app"
• Application: Repository URL = https://github.com/Timborimbo/hyggecraftery_APP.git
• Application: Branch = main
• Repository in GitHub App konfiguriert
• Deploy gestartet
• Build erfolgreich

---

🎯 Zusammenfassung

1. ✅ GitHub App erstellt
2. Application konfigurieren: Private Repository + GitHub App
3. Deployen: Fertig! 🎉

Die GitHub App ist die beste Lösung für private Repositories - viel einfacher als Deploy Keys!