Initialer Commit: Projekt Start

COOLIFY_GITHUB_APP.md

@@ -0,0 +1,114 @@
+# 🔗 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:
+  ```bash
+  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!
+