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:

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:

nano ~/nixos-config/configuration.nix

Suche diese Zeile (ca. Zeile 13):

desktopConfig = ./modules/desktop/kde.nix;

Ändere sie zu:

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):

graphicsConfig = ./modules/graphics/mesa-amd.nix;

Falls du NVIDIA hast:

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:

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:

cd ~/nixos-config

Option A: Mit Flakes (EMPFOHLEN)

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)

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

---

Schritt 6: System neu starten

Nach erfolgreichem Build:

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):

# 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:

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:

# 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:

   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:

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

cosmic-terminal
# Rechtsklick → Preferences

3. Steam installieren (für Gaming)

# 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:

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

Beispiele zum Hinzufügen:

environment.systemPackages = with pkgs; [
  firefox       # Browser
  vlc           # Media Player
  vscode        # Editor
];

Dann rebuild:

sudo nixos-rebuild switch --flake .#template

---

Zurück zu KDE (Falls es nicht passt)

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

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