Documentation
UrsaOS Dokumentation
Vollständiger Leitfaden zur Installation, Konfiguration und Nutzung der Linux-Distribution UrsaOS.
Systemvoraussetzungen
Prozessor
x86_64 Prozessor
Firmware
UEFI-Firmware (Secure Boot deaktiviert, GPT-Partitionierung)
Arbeitsspeicher
Mindestens 2 GiB RAM (4 GiB+ empfohlen)
Speicherplatz
Mindestens 12 GiB freier Speicherplatz (20 GiB+ empfohlen)
Grafik
Wayland-fähige Grafikkarte (Intel, AMD oder NVIDIA)
Legacy BIOS / CSM und MBR-Installationen werden von aktuellen UrsaOS-Images nicht mehr unterstützt (UEFI-only).
Live-System & Boot
- ISO booten und im GRUB-Textmenü die Sprache wählen: 'UrsaOS starten — Deutsch' oder 'Start UrsaOS — English'.
- Der ephemere Live-Benutzer ursa startet automatisch in der Plasma Wayland-Session.
- Netzwerkverbindungen werden über NetworkManager verwaltet.
- Recovery: 'Erweiterte Optionen → Sichere Konsole' (Boot-Parameter ursaos_console=1) startet direkt eine Root-Konsole.
Geführte Calamares-Installation
Die geführte Installation wird über 'Install UrsaOS' im App-Launcher oder per Befehl 'ursaos-install' im Terminal gestartet. Calamares kopiert den genauen Zustand der getesteten Live-ISO offline auf deine Festplatte.
Standard-Konfiguration (Defaults)
| Bereich | UrsaOS Standard |
|---|---|
| Desktop | Das laufende UrsaOS Plasma Live-Payload |
| Bootloader | UEFI + GPT + nativer Text-GRUB |
| Dateisystem | Btrfs mit Subvolumes @, @home, @cache, @log (compress=zstd:3, noatime) |
| Kernel | linux-Kernel (empfohlen optional: linux-lts) |
| Snapshots | Snapper (Standard), Timeshift oder keines |
| Login-Greeter | SDDM mit UrsaOS Aurora Greeter |
| Shell | Fish Shell für neu angelegte Benutzer |
| Software | BearHub (empfohlen, deinstallierbar), Flatpak, repo.ursaos.dev |
| AUR | Ab Werk deaktiviert; optional paru + base-devel wählbar |
Btrfs-Snapshot Optionen
Snapper (Empfohlen)
Root-Konfiguration, Benutzerrechte, Timeline-Timer, grub-btrfsd und Btrfs Assistant GUI.
Timeshift
Snapper-Integration wird entfernt; Timeshift und cronie verbleiben für periodische Backups.
Keine Snapshots
Sowohl Snapper als auch Timeshift und deren Bootloader-Integrationen werden vollständig entfernt.
Wichtige Tastenkürzel (Plasma)
Super + E
Kitty Terminal öffnen (mit Fish, Starship & Fastfetch)
Super + Q
Aktives Fenster schließen
Meta
Application Launcher öffnen
Super + ,
Systemeinstellungen öffnen
ISO & Pakete aus Quellcode bauen
sudo pacman -Syu --needed archiso git base-devel pacman-contrib \
extra-cmake-modules libglvnd ninja python qt6-tools qt6-translations \
kcoreaddons kcrash kpmcore libpwquality qt6-declarative qt6-svg yaml-cpp
./scripts/build-package.sh all
sudo ./scripts/build-iso.sh