Administrator-Handbuch
Täglicher Betrieb
Bluefin ist dafür ausgelegt, für die Lebensdauer der Hardware ohne Neuinstallation installiert zu werden. Im Gegensatz zu herkömmlichen Betriebssystemen ist das Image immer unverändert und „sauber“, wodurch Upgrades weniger problematisch sind. Updates sind standardmäßig automatisch und still.
Das bedeutet in der Regel, dass du dein System einmal einrichten kannst und es dann so bleibt. Dann musst du wahrscheinlich nie mehr hierher zurückkommen. 🙂
I want that "defaults lifestyle".
-- Matt Ray

Anwendungen installieren
Verwende Bazaar, um Anwendungen aus Flathub zu installieren. System-Updates und Upgrades werden nicht von dieser Anwendung verwaltet; ihr Umfang wurde auf die Installation von Flatpaks aus Flathub reduziert. Zwei Flatpak-Verwaltungswerkzeuge sind enthalten:
- Warehouse bietet Anwendungsverwaltung.
- Flatseal ist ebenfalls für die Berechtigungsverwaltung enthalten.
System-Updates
Bluefin ist so konzipiert, dass es „ohne Zutun“ funktioniert. Das System prüft alle sechs (6) Stunden auf Updates. Dies umfasst System-Updates, Flatpaks, Pet-Container und Homebrew.
- Die meisten Images werden wöchentlich veröffentlicht, wir können aber jederzeit ein neues Update herausgeben.
Updates werden beim Neustart des Systems angewendet. Daher wird empfohlen, dein Gerät regelmäßig auszuschalten, wenn es nicht benutzt wird, um sicherzustellen, dass Kernel-Updates angewendet werden. Anwendungs-Updates (wie der Browser) erfolgen unabhängig davon und erfordern keinen Neustart.
Maschinen-Firmware-Updates werden über die Firmware-Anwendung bereitgestellt.

Updates verwalten
Gehe in Einstellungen → Netzwerk → einer Netzwerkeinstellung und setze Metered Connection: has data limits or can incur charges, um Bluefin-Updates zu pausieren:

Streams und Drosselungseinstellungen
Bluefin bietet Images basierend auf der aktuellen Fedora-Version. Damit haben Nutzer die Wahl, wie aggressiv sie ihre Updates wünschen. Diese werden als „Streams“ bezeichnet.
Bluefin
stable: Dies ist der Standard-Stream für Bluefin und richtet sich an die meisten Nutzer. Er ist immer ein Alias auf die aktuelle Fedora-Version, folgt aber dem Fedora-CoreOS-Veröffentlichungszeitplan. Das bedeutet, dass Kernel-Upgrades etwa 2 Wochen nach dem Erscheinen in Fedora kommen, was nützlich sein kann, um Kernel-Regressionen zu vermeiden, da das Bluefin-Team in diesen Fällen auf einen bestimmten Kernel pinnen kann. Wir nennen dies „Gating“ des Kernels. stable-daily ist für diejenigen verfügbar, die tägliche Builds möchten.
latest: Für Nutzer, die das Neueste wollen, was Fedora zu bieten hat — einen ungegateten Linux-Kernel, tägliche Updates, voller offener Gasfuß. 🔥 Dieser Stream bleibt absichtlich ungebrandet und ist nicht für den allgemeinen Gebrauch bestimmt.
Du kannst aus drei Rolling-Tags wählen oder auf eine bestimmte Fedora-Version festlegen. Sieh in die Release Notes für versionsspezifische Informationen:
stable (Standard) oder stable-daily | latest | |
|---|---|---|
| Fedora-Version: | 43 | 43 |
| GNOME-Version: | 49 | 49 |
| Zielnutzer: | Alle Nutzer | |
| System-Updates: | Wöchentlich oder täglich | Täglich |
| Anwendungs-Updates: | Zweimal täglich | Zweimal täglich |
| Kernel: | Gegatet | Ungegatet |
Der Hauptunterschied zwischen latest und stable ist die Kernel-Kadenz und wann sie ein großes Upgrade durchführen. latest aktualisiert auf die nächste Fedora-Hauptversion, sobald sie verfügbar ist, und baut täglich. stable aktualisiert, wenn CoreOS sein Userspace-Upgrade durchführt, was normalerweise einige Wochen danach ist, und baut wöchentlich oder täglich. Nutzer können das stable-daily-Image für tägliche stabile Updates wählen oder bei stable für wöchentliche Builds bleiben.
Gegateter Kernel
Das stable-Tag hat einen gegateten Kernel. Dieser Kernel folgt der gleichen Version wie der Fedora-CoreOS-Stable-Stream, was eine langsamere Kadenz als das Standard-Fedora-Silverblue ist. Das Universal-Blue-Team kann vorübergehend auf einen bestimmten Kernel pinnen, um Regressionen zu vermeiden, die Nutzer betreffen könnten.
Hinzufügen und Bearbeiten von Kernel-Boot-Argumenten wird von bootc kargs gehandhabt. Sieh in die Upstream-Dokumentation für weitere Informationen.
Bluefins Komponenten werden über alle Images geteilt; betrachte es nicht als separate „Edition“ oder „Spin“. Bluefin ist bestrebt, über alle Images hinweg gleich zu sein; wir glauben, dass die Aggressivität von Updates eine „Einstellung“ sein kann. Idealerweise nutzt du „Bluefin“ und musst dich nicht um deinen Update-Stream kümmern.
Zwischen Streams wechseln
Verwende den Befehl ujust rebase-helper, um ein Rebase auszuwählen und einen bestimmten Stream zu wählen:

Oder wähle date und ein älteres Image.

Manuell zwischen Streams wechseln
Bluefin verwendet bootc, um das Betriebssystem-Image zu verwalten. Um deine aktuellen und gestagten Deployments zu inspizieren, führe aus:
sudo bootc status
Dies zeigt dein gebootetes Image, gestagedes Update (falls vorhanden) und Rollback-Ziel:
Current staged image: ghcr.io/projectbluefin/bluefin:stable
Image version: 43.20260901.0
Image digest: sha256:...
Current booted image: ghcr.io/projectbluefin/bluefin:stable
Image version: 43.20260825.0
Image digest: sha256:...
Die Referenz ghcr.io/projectbluefin/bluefin:stable gibt das Image und das Stream-Tag an. Suche nach :stable, :latest oder gepinnten Datums-Tags.
Wenn du lokal gelayerte Pakete hast, setze sie vor dem Stream-Wechsel zurück:
rpm-ostree reset
Profi-Tipp: Bluefins Release Notes enthalten Stream-Wechsel-Anweisungen für jede Veröffentlichung.
Verwende den Befehl bootc switch, um zu einem anderen Stream zu wechseln:
Beispiele für manuelle Wechsel
Wechsel zu :stable. Das --enforce-container-sigpolicy-Flag stellt die Signaturprüfung für das Ziel-Image sicher:
sudo bootc switch ghcr.io/projectbluefin/bluefin:stable --enforce-container-sigpolicy
Wechsel zu :testing:
sudo bootc switch ghcr.io/projectbluefin/bluefin:testing --enforce-container-sigpolicy
Wechsel zu NVIDIA-Hardware-Images:
sudo bootc switch ghcr.io/projectbluefin/bluefin-nvidia:stable --enforce-container-sigpolicy
Auf ein bestimmtes Datums-Tag pinnen:
sudo bootc switch ghcr.io/projectbluefin/bluefin:stable-20260825 --enforce-container-sigpolicy
Auf das vorherige Deployment zurückrollen:
sudo bootc rollback
Verwende skopeo inspect, um Image-Metadaten und verfügbare Tags abzufragen:
skopeo inspect docker://ghcr.io/projectbluefin/bluefin:stable
Dies zeigt alle verfügbaren Tags und nützliche Metadaten wie Image- und Kernel-Versionen.
Sieh in die bootc-Dokumentation für weitere Informationen.
Virtuelle Private Netzwerke (VPN)
Tailscale ist standardmäßig enthalten, um VPN-Dienste sowohl für Desktop- als auch für Entwicklungs-Anwendungsfälle bereitzustellen. Tailscale ist ziemlich nützlich.
- Tailscale mit Mullvad verwenden - bietet die beste Out-of-the-Box-Erfahrung
- Tailscale mit Docker verwenden - für die Entwicklung
- Den Systray mit Tailscale verwenden - folge dies, um das Tailscale-Symbol im Systray einzurichten. Beachte, dass
wl-clipboardbereits im System enthalten ist, du musst es also nicht installieren. - Tailscales YouTube-Kanal hat viele großartige Tipps und Tricks
- Gute VPN-Anbieter stellen Wireguard-Konfigurationen bereit, die direkt in den Network Manager importiert werden können; sieh in deren Dokumentation für weitere Informationen:
Es gibt auch VPN-Anbieter auf Flathub, die eine gute Erfahrung bieten:
- Mozilla VPN (Spenden)
- ProtonVPN-Client - auf Flathub verfügbar
Andere VPN-Anbieter, die hier nicht explizit erwähnt werden, bieten möglicherweise eine schlechte Paketierungserfahrung und werden nicht empfohlen. Wenn dein VPN-Anbieter in diese Kategorie fällt, ist möglicherweise der Export der Wireguard-Konfiguration und der manuelle Import der beste Ansatz.
Lokales Layering
Das direkte Hinzufügen von Paketen zum Host-Image wird in Bluefin nicht empfohlen. Das Betriebssystem ist so konzipiert, dass es unverändert und reproduzierbar als von bootc verwaltetes OCI-Image bleibt.
Workloads sollten in Containern isoliert werden (via Distrobox oder Devcontainers), CLI-Tools über Homebrew installiert und grafische Anwendungen aus Flathub installiert werden.
Wenn du vorübergehend ein Host-Paket layern musst:
rpm-ostree install <package>
Um alle gelayerten Pakete zu entfernen und zur reinen Image-Basis zurückzukehren:
rpm-ostree reset
Zum Anwenden neu starten.
| Empfohlene Alternative | Vermeide Layering auf dem Host |
|---|---|
| Flatpak-Apps | Grafische Desktop-Apps |
| Homebrew-CLI-Tools | Host-Utilities |
| Distrobox / Container | Developer-Runtimes |
System-Standardeinstellungen überschreiben
Bluefin-Systemstandards werden auf dem Basis-Image zusammen mit der Fedora-Konfiguration in /usr/etc ausgeliefert. Die meisten davon können überschrieben werden, indem eine Datei in /etc abgelegt wird.
Zum Beispiel befindet sich die Distrobox-Konfiguration in /usr/etc/distrobox/distrobox.ini. Deine Anpassungsoptionen werden in /etc/distrobox/distrobox.ini abgelegt. Dies ist nützlich, wenn du eine Kopie der Originaldatei als Referenz benötigst.
Sieh in die XDG Base Directory Specification für weitere Informationen zu Konfigurationsoptionen, insbesondere ~/.local und ~/.config.
Community-Aliase und Workarounds
just wird als Task-Runner auf Bluefin verwendet. Dies sind üblicherweise Community-Bequemlichkeits-Aliase oder komplexere Skripte, die helfen, einige Aufgaben oder Ersteinrichtung zu automatisieren. Dies ist als ujust aliasiert, damit du just selbst für deine anderen Projekte verwenden kannst.
Erste Schritte mit ujust
ujust --choose- Zeigt jeden Befehl und das Skript, das ausgeführt wird, wenn dieser Befehl gewählt wird. Nützlich, um die verfügbaren Befehle zu durchsuchenujust -n $command- Das-nführt einen Befehl im Dry-Run-Modus aus, was nützlich ist, um die ausgeführten Befehle zu inspizieren
Profi-Tipp: Halte deine eigenen Tasks und Aliase in ~/.Justfile, und sie eignen sich auch gut, um sie im Stammverzeichnis deiner Projektdateien abzulegen, um gängige Tasks zu automatisieren; sieh dir dieses von Fedora Kinoite an.
Kuratierte Tool-Bundles
Bluefin enthält kuratierte CLI-Tool-Sammlungen. Diese Befehle installieren kuratierte Sammlungen von Tools via Homebrew:
| Befehl | Beschreibung |
|---|---|
ujust bluefin-cli | Moderne CLI-Tools: atuin, bat, chezmoi, direnv, eza, fd, gh, glab, ripgrep, starship, tealdeer, television, zoxide und mehr |
Systembefehle
| Befehl | Beschreibung |
|---|---|
ujust update | System, Flatpaks und Brew-Formeln manuell aktualisieren |
ujust toggle-updates | Automatische System-Updates aktivieren oder deaktivieren |
ujust changelogs | Changelogs für jedes Paket seit dem letzten Update anzeigen |
ujust bios | Den PC neu starten und in das BIOS/UEFI wechseln. Nützlich für Dual-Boot-Systeme mit unabhängigen Festplatten |
ujust bios-info | BIOS/UEFI-Informationen anzeigen (Hersteller, Produktname, Version, Veröffentlichungsdatum) |
ujust device-info | Sendet den Status, die Flatpak-Liste und Systeminformationen an den CentOS-Pastebin und gibt die URL im Terminal aus. Dies ermöglicht es dem Endnutzer, die URL mit seinen Informationen bequem einzufügen, damit andere beim Debuggen helfen können |
ujust rebase-helper | Interaktiver Assistent zum Wechseln zwischen Streams, Rebase auf andere Images oder Zurückrollen auf eine frühere Version |
ujust clean-system | Nicht verwendete Container, Volumes und Flatpak-Runtimes aufräumen |
ujust check-idle-power-draw | Leerlaufleistungsaufnahme deines Systems mit powerstat messen |
ujust check-local-overrides | Dateien anzeigen, die sich zwischen /usr/etc und /etc unterscheiden, um lokale Anpassungen zu identifizieren |
ujust logs-this-boot | Alle System-Logmeldungen vom aktuellen Boot anzeigen |
ujust logs-last-boot | Alle System-Logmeldungen vom vorherigen Boot anzeigen |
ujust enroll-secure-boot-key | Den Nvidia-Treiber- & KMOD-Signierschlüssel für Secure Boot enrollen (Passwort: „universalblue“) |
ujust toggle-user-motd | Anzeige der „Message of the Day“ im Terminal umschalten |
ujust toggle-tpm2 | Automatisches LUKS-Disk-Unlock via TPM umschalten (aktivieren/deaktivieren mit optionaler PIN) |
ujust toggle-iwd | Zwischen iwd und wpa_supplicant für WLAN-Netzwerke wechseln (iwd kann Durchsatz verbessern und Latenz reduzieren) |
ujust benchmark | Einen einminütigen System-Benchmark mit stress-ng ausführen |
ujust powerwash | Diesen Rechner auf den Anfangszustand zurücksetzen (experimentelles Feature) |
Developer-Experience-Befehle
| Befehl | Beschreibung |
|---|---|
ujust devmode | Zwischen Bluefin und der Developer Experience (bluefin-dx) umschalten |
ujust dx-group | Deinen Benutzer zu den Gruppen docker, incus-admin, libvirt und dialout für vollen Entwicklerzugriff hinzufügen |
ujust bluefin-cli | Bluefins kuratiertes Command-Line-Erlebnis mit modernen Tools installieren (atuin, bat, eza, fd, ripgrep, starship, zoxide und mehr) |
ujust toggle-devmode | Alias für ujust devmode |
Befehle zur Anwendungsinstallation
| Befehl | Beschreibung |
|---|---|
ujust jetbrains-toolbox | JetBrains Toolbox zur Verwaltung von JetBrains-IDEs installieren |
ujust install-opentabletdriver | OpenTabletDriver, einen Open-Source-Treiber für Grafiktabletts, installieren oder deinstallieren |
ujust install-system-flatpaks | Die Standard-System-Flatpaks installieren (nützlich nach einem Rebase) |
ujust install-system-flatpaks-extra | Zusätzliche empfohlene Flatpak-Anwendungen installieren |
Generell versucht Bluefin, die System-Justfiles fein abzugrenzen; die meisten davon sind Workarounds und keine vollwertigen Befehle. Sie können entfernt oder geändert werden, je nachdem, welches Problem sie ursprünglich lösen sollten.
Erweiterungen verwalten
Bluefin verwendet den Extension Manager von Matthew Jakeman zur Verwaltung der Desktop-Erweiterungen. Die Anwendung ist standardmäßig enthalten. Du kannst sie über das Logo-Menü aufrufen (danke Aryan Kaushik!)

Dies ist nützlich, wenn du entscheidest, dass du einige der mit Bluefin gebündelten Erweiterungen nicht verwenden möchtest.

In dem unwahrscheinlichen Fall, dass deine Session abstürzt, werden alle deine Erweiterungen deaktiviert. In dem seltenen Fall, dass dies passiert, musst du möglicherweise alle im Erweiterungs-Manager wieder aktivieren.
Fernverwaltung
Dieses Feature ist unvollständig und benötigt Mitwirkende, um es Realität werden zu lassen
Bluefin und Aurora enthalten Cockpit zur Maschinenverwaltung. Wir hoffen, weitere Out-of-the-Box-Verwaltungsvorlagen aufzunehmen; bitte sieh dir dieses Issue an, wenn du dich freiwillig beteiligen möchtest.
Verifizierung
Diese Images sind mit sigstores cosign signiert. Bluefin Classic verwendet schlüsselbasierte Signierung, also verifiziere es mit dem cosign.pub-Schlüssel aus ublue-os/bluefin:
cosign verify --key https://raw.githubusercontent.com/ublue-os/bluefin/main/cosign.pub \
ghcr.io/ublue-os/bluefin:stable
Dakota und Utah sind stattdessen schlüssellos signiert — siehe Supply Chain Security für deren Verifizierungsbefehle.