# 🔗 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!