nixos-vorlagen/docs/COSMIC_SETUP_ANLEITUNG.md

# COSMIC Desktop Umstieg - Schritt-für-Schritt Anleitung

Anleitung zum Wechsel von deinem aktuellen NixOS 26.05 Setup zu COSMIC Desktop Environment.

## Voraussetzungen

- NixOS 26.05 installiert ( dein aktueller Stand)
- Zugriff auf Terminal/SSH
- Die Dateien im `~/nixos-config` Verzeichnis

---

## Schritt 1: Backup erstellen

Bevor wir Änderungen machen, ein Backup der aktuellen Konfiguration:

```bash
cd ~/nixos-config
git status
git add -A
git commit -m "Backup vor COSMIC Umstieg"
```

**Was das macht:**
- Git speichert deinen aktuellen Zustand
- Falls etwas schiefgeht, kannst du mit `git revert` zurückgehen

---

## Schritt 2: configuration.nix anpassen

Öffne die Datei:
```bash
nano ~/nixos-config/configuration.nix
```

**Suche diese Zeile** (ca. Zeile 13):
```nix
desktopConfig = ./modules/desktop/kde.nix;
```

**Ändere sie zu:**
```nix
desktopConfig = ./modules/desktop/cosmic-max.nix;
```

**Speichern & Schließen:**
- Drücke `Ctrl+O` → `Enter`
- Drücke `Ctrl+X`

---

## Schritt 3: Optional - GPU-Treiber überprüfen

Für COSMIC empfohlen: AMD-Treiber oder NVIDIA 550+

**Aktuelle Einstellung überprüfen** (Zeile 20):
```nix
graphicsConfig = ./modules/graphics/mesa-amd.nix;
```

Falls du NVIDIA hast:
```nix
graphicsConfig = ./modules/graphics/nvidia-open.nix;
```

---

## Schritt 4: Flake.nix überprüfen

Die `flake.nix` braucht keinen Umbau - sie hat schon alles für COSMIC:

```bash
cat ~/nixos-config/flake.nix
```

 Sollte enthalten:
- `chaotic.url = "github:chaotic-cx/nyx/nyxpkgs-unstable"` (für aktuelle Pakete)
- Extra Substituter für `nyx-cache.chaotic.cx`

Falls nicht: Die bestehende `flake.nix` ist optimal, brauchst nichts ändern.

---

## Schritt 5: Update durchführen (Der wichtige Schritt!)

Öffne Terminal im Projekt-Verzeichnis:

```bash
cd ~/nixos-config
```

### Option A: Mit Flakes (EMPFOHLEN)

```bash
sudo nixos-rebuild switch --flake .#template
```

**Was das macht:**
- Lädt alle Abhängigkeiten herunter
- Compiliert die neue Config
- Wechselt sofort zu COSMIC
- Dauert: 5-15 Minuten (je nach Internetverbindung & Hardware)

### Option B: Ohne Flakes (Falls Probleme mit A)

```bash
sudo nixos-rebuild switch -I nixpkgs=/nix/var/nix/profiles/per-user/root/channels/nixos
```

---

## Schritt 6: System neu starten

Nach erfolgreichem Build:

```bash
sudo reboot
```

**Bei Neustart:**
- COSMIC-Greeter (Login-Bildschirm) sollte erscheinen
- Melde dich an
- COSMIC Desktop startet

---

## Schritt 7: Überprüfung

Nach dem Login, öffne ein Terminal (`Ctrl+Alt+T` oder über Launcher):

```bash
# Zeigt dein aktuelles Desktop Environment
echo $DESKTOP_SESSION

# Sollte zeigen:
# cosmic
```

Prüfe auch:
- **Systemeinstellungen** (cosmic-settings) funktionieren?
- **Dateiverwaltung** (cosmic-files) funktioniert?
- **Terminal** (cosmic-terminal) startet?

---

## Troubleshooting

### Problem: `error: flake not found`

**Lösung:**
```bash
cd ~/nixos-config
nix flake update
sudo nixos-rebuild switch --flake .#template
```

### Problem: NVIDIA + schwarzer Bildschirm

**Das ist normal beim ersten Start mit NVIDIA.**

Lösung:
```bash
# Starte in TTY (Ctrl+Alt+F2)
# Melde dich an
sudo nixos-rebuild switch --flake .#template
sudo reboot
```

### Problem: COSMIC startet nicht / bleibt bei Login hängen

**Fallback zu KDE:**
1. Öffne Terminal: `Ctrl+Alt+F2`
2. Melde dich an
3. Ändere `configuration.nix` zurück:
   ```bash
   nano ~/nixos-config/configuration.nix
   # Ändere desktopConfig = ./modules/desktop/kde.nix;
   ```
4. Rebuild: `sudo nixos-rebuild switch --flake .#template`

### Problem: `chaotic.nixosModules.default` nicht gefunden

**Lösung - Flakes neuladen:**
```bash
cd ~/nixos-config
nix flake update
sudo nixos-rebuild switch --flake .#template
```

---

## Nach der Installation: Erste Schritte

### 1. Grundeinstellungen

Öffne **COSMIC Settings** (cosmic-settings):
- Zeitzone prüfen
- Tastaturlayout einstellen
- Bildschirmauflösung anpassen
- Netzwerk verbinden

### 2. Terminal konfigurieren

```bash
cosmic-terminal
# Rechtsklick → Preferences
```

### 3. Steam installieren (für Gaming)

```bash
# Bereits in modules/gaming.nix eingebunden
# Überprüfe mit:
which steam

# Oder starten:
steam
```

### 4. Zusätzliche Tools installieren (Optional)

Falls du weitere Anwendungen brauchst, edit `modules/packages.nix`:

```bash
nano ~/nixos-config/modules/packages.nix
```

Beispiele zum Hinzufügen:
```nix
environment.systemPackages = with pkgs; [
  firefox       # Browser
  vlc           # Media Player
  vscode        # Editor
];
```

Dann rebuild:
```bash
sudo nixos-rebuild switch --flake .#template
```

---

## Zurück zu KDE (Falls es nicht passt)

Falls COSMIC nicht für dich funktioniert, einfach zurück:

```bash
# configuration.nix
desktopConfig = ./modules/desktop/kde.nix;

# Dann:
sudo nixos-rebuild switch --flake .#template
```

---

## Häufige Fragen

**F: Wird meine Festplatte gelöscht?**
A: Nein! `nixos-rebuild switch` ist nicht-destruktiv. Alte Konfigurationen bleiben auf der Festplatte.

**F: Wie lange dauert der Umbau?**
A: 5-30 Minuten. Hängt ab von: Internet, CPU, HDD/SSD, Cachegröße.

**F: Kann ich zwischendurch abbrechen?**
A:  Besser nicht. Wenn es hängt, lass es laufen oder force-kill mit `Ctrl+C` und retry.

**F: Kann ich rollback machen?**
A: Ja! Boot-Menü zeigt alte Generationen. `systemctl revert` bei Fehler.

---

## Erfolgreiche Installation

Wenn alles funktioniert:
- COSMIC startet
- Alle Tools laden
- Steam funktioniert (wenn installiert)
- Internet läuft

**Glückwunsch! Du bist auf COSMIC umgestiegen.**

---

## Notizen

- **NixOS 26.05** → vollständig kompatibel
- **COSMIC** → Wayland-native, moderne Alternative
- **Chaotic Nyx** → Liefert aktuelle GPU-Treiber
- **Dein Gaming-Setup** → Behält alle Spiele-Features

Viel Erfolg!