Installation
ShivaOS Atomic is distributed as a bootable ISO image. You need a USB drive of at least 8 GB and a UEFI-compatible PC.
Requirements
Minimum
CPU: x86_64 64-bit
RAM: 4 GB
Storage: 40 GB
UEFI Boot
Recommended
CPU: 4+ cores
RAM: 8 GB+
Storage: 60 GB+ SSD
GPU: AMD / Intel / NVIDIA
Installation steps
dd:sudo dd if=shivaos-atomic.iso of=/dev/sdX bs=4M status=progressFirst boot
On the first boot, ShivaOS automatically compiles GPU drivers and runs the welcome wizard.
Welcome wizard
The Shiva Welcome wizard guides you through 6 steps: Welcome, GPU, Apps, Controller, Wallpaper, and Ready. At the end, the system reboots automatically to apply all settings.
Set hostname (recommended)
To avoid potential KDE/Wayland issues, set a hostname after first boot:
sudo hostnamectl set-hostname shivaos
Updates
ShivaOS Atomic uses rpm-ostree for system updates. Unlike traditional package managers, updates are applied atomically — the old system is preserved and can be restored instantly.
Manual update
rpm-ostree upgrade
systemctl reboot
Rollback
If something goes wrong after an update, roll back to the previous version:
rpm-ostree rollback
systemctl reboot
Check status
rpm-ostree status
Steam & Proton
Steam and Proton are pre-installed. Most Windows games run out of the box via Proton.
Enable Proton for all games
Proton-GE (better compatibility)
Install Proton-GE from Shiva Commander → Proton-GE tab for improved game compatibility.
Useful launch options
| Option | Effect |
|---|---|
| PROTON_LOG=1 %command% | Enable Proton logs for debugging |
| DXVK_ASYNC=1 %command% | Async shader compilation (less stutters) |
| gamemoderun %command% | Activate GameMode for this game |
| mangohud %command% | Show MangoHUD performance overlay |
Performance
ShivaOS includes performance tools pre-configured. Here's how to use them.
MangoHUD
MangoHUD shows real-time FPS, CPU, GPU and RAM usage. Enable it per game with the launch option above, or globally:
MANGOHUD=1 steam
GameMode
GameMode optimises CPU scheduling and power profile when a game is running. It activates automatically with the gamemoderun launch option.
Kernel BORE ShivaOS
ShivaOS uses a custom kernel based on Fedora vanilla with the BORE scheduler patch and BBR3 — optimised for low-latency gaming. No configuration needed.
Low-Latency Layer
Low-Latency Layer is a Vulkan implicit layer pre-installed on ShivaOS. It brings NVIDIA Reflex and AMD Anti-Lag latency reduction to all GPUs — AMD, Intel and NVIDIA included. No specific driver required.
Add these Steam launch options to enable it for a game:
PROTON_FORCE_NVAPI=1 LOW_LATENCY_LAYER_REFLEX=1 LOW_LATENCY_LAYER_SPOOF_NVIDIA=1 %command%
ananicy-cpp — Priorité processus automatique
ananicy-cpp est un daemon pré-installé et actif sur ShivaOS. Il ajuste automatiquement la priorité CPU et I/O de tous les processus en cours (jeux, Proton, audio) sans aucune configuration. Les jeux détectés reçoivent une priorité élevée, les tâches de fond sont abaissées.
vkBasalt — CAS Sharpening
vkBasalt est une couche Vulkan implicite pré-configurée sur ShivaOS. Elle applique CAS sharpening (0.4) et FXAA (0.75) sur tous les jeux Vulkan/DXVK pour une image plus nette. Activez-la dans Shiva Commander → Tweaks → vkBasalt Global, ou via :
ENABLE_VKBASALT=1 %command%
Gaming QoS réseau
shiva-qos.service s'active au boot et priorise le trafic UDP gaming via tc qdisc. Résultat : latence réseau réduite pour les jeux en ligne sans aucune configuration.
Alerte température GPU
Un timer systemd vérifie la température GPU toutes les 30 secondes. Si elle dépasse 85°C, une notification bureau s'affiche automatiquement. Fonctionne avec NVIDIA (nvidia-smi) et AMD (hwmon).
NVIDIA
NVIDIA drivers are handled automatically by akmod-nvidia. The proprietary driver compiles on first boot.
Shiva Nvidia tool
Open Shiva Nvidia from the app menu to switch between open-source (nouveau) and proprietary drivers, or repair the driver installation.
Manual repair
If drivers fail to load after an update:
sudo akmods --force sudo dracut --force sudo systemctl reboot
GTX 900 / GTX 1000 series (Maxwell / Pascal)
GTX 900 and GTX 1000 series are no longer supported by the standard akmod-nvidia driver. ShivaOS automatically detects these GPUs and installs akmod-nvidia-580xx instead — the last driver branch supporting Pascal and Maxwell. This is handled automatically by the Shiva Nvidia tool. Additionally, since 580xx drivers do not support Wayland, ShivaOS automatically sets Plasma (X11) as the default SDDM session at boot — no manual action required.
If the automatic switch fails, you can install the driver manually:
sudo rpm-ostree override remove akmod-nvidia-open \ --install akmod-nvidia-580xx \ --install xorg-x11-drv-nvidia-580xx \ --install nvidia-gpu-firmware sudo rpm-ostree kargs \ --append=rd.driver.blacklist=nouveau,nova_core \ --append=modprobe.blacklist=nouveau,nova_core \ --append=nvidia-drm.modeset=1 sudo systemctl reboot
Secure Boot
If Secure Boot is enabled, the NVIDIA kernel module compiled by akmod will not load — the system will boot with nouveau (or a black screen). You have two options:
Legacy GPUs (GTX 700 and older)
GTX 700 series and older are no longer supported by recent NVIDIA drivers. Shiva Nvidia will display a warning. Use the open-source nouveau driver instead.
AMD GPU
AMD GPUs are fully supported out of the box on ShivaOS via the open-source amdgpu driver built into the kernel. No additional installation required.
Shiva AMD
Open Shiva AMD from the app menu to monitor your GPU in real time (temperature, usage, VRAM, clocks, fan speed) and switch performance profiles (Eco / Balanced / Performance).
Advanced control — LACT
For overclocking, fan curves and voltage control, install LACT (Linux AMD Control Tool) directly from Shiva AMD or Shiva Commander → Contrôle & RGB.
flatpak install flathub io.github.lact_ui
Performance profiles (manual)
echo performance | sudo tee /sys/class/drm/card0/device/power_dpm_force_performance_level
Values: auto (default), low, high, manual. Shiva AMD handles this graphically.
Shiva Commander
Shiva Commander est le Gaming Hub central de ShivaOS. Il centralise la gestion des jeux, des pilotes, des mises à jour et des outils de performance en une seule interface.
Bibliothèque de jeux
L'onglet Bibliothèque scanne automatiquement Steam, Heroic Games Launcher et Lutris. Tous vos jeux apparaissent dans une liste unifiée avec lancement en un clic.
Profils par jeu
L'onglet Profils Jeux permet d'assigner un profil (Gaming, Normal ou Économie) à chaque jeu Steam. Shiva Commander génère automatiquement les options de lancement à coller dans les propriétés Steam du jeu.
Mode Tournoi
Le Mode Tournoi force le CPU en mode performance, ferme Discord et les navigateurs, et réduit la latence audio Pipewire au minimum. Désactivez-le après la session pour revenir en mode normal.
RAM Booster
Le bouton RAM Booster dans l'onglet Système libère le cache mémoire système (page cache + dentries + inodes) et affiche la quantité de RAM récupérée avant/après.
Auto-update Proton-GE
L'onglet Proton-GE inclut un bouton de mise à jour automatique. Il interroge l'API GitHub pour détecter la dernière version de GE-Proton et la télécharge directement dans ~/.steam/root/compatibilitytools.d/.
Distrobox — Containers Linux
L'onglet Distrobox permet de lancer n'importe quelle distro Linux dans un container intégré à votre bureau. Arch, Ubuntu, Debian, Fedora, openSUSE ou Void Linux — sélectionnez, installez et entrez dans le container en un clic. Vos fichiers /home sont partagés automatiquement et les applications graphiques s'ouvrent directement sur votre bureau.
Fonds d'écran
L'onglet Fonds affiche tous les wallpapers ShivaOS en premier (Neon Grid, Deep Space, Lava Core, Cyber Rain, Aurora, Void + The Forge original), suivis des fonds KDE inclus. Cliquez pour appliquer instantanément.
Changement d'édition
L'onglet Éditions permet de basculer vers une autre édition ShivaOS sans réinstaller. Cliquez sur Switcher →, confirmez, et un terminal s'ouvre pour télécharger la nouvelle image puis redémarrer automatiquement.
Distrobox
Distrobox permet d'exécuter n'importe quelle distribution Linux dans un container intégré à ShivaOS — sans dual boot, sans VM. Vos fichiers /home sont partagés, les applications graphiques s'affichent sur votre bureau.
Via Shiva Commander
Ouvrez Shiva Commander → Distrobox, choisissez une distro et cliquez Installer. Une fois créé, cliquez Entrer → pour ouvrir un terminal dans le container.
Via terminal
# Créer un container Arch Linux
distrobox create --name arch --image archlinux:latest
# Entrer dans le container
distrobox enter arch
# Lancer une app graphique depuis le container
distrobox enter arch -- firefoxCas d'usage
Accédez à l'AUR depuis un container Arch, installez des paquets Debian non disponibles sur Fedora, ou testez des outils dans un environnement isolé. Le container voit votre /home complet — vos fichiers sont accessibles directement.
Shiva AI
ShivaOS intègre 7 modules d'intelligence artificielle qui tournent en arrière-plan. Tous utilisent le proxy Groq (Llama 3.3) via shivaos.com — gratuit, sans inscription.
shiva — lance l'assistant en mode conversationnel.🔱 Overlay : Super+A — overlay flottant par-dessus n'importe quelle fenêtre (KDE).
7 modules actifs en arrière-plan
Surveille journalctl en temps réel. Si une erreur critique est détectée (GPU bloqué, OOM, crash Proton, erreur disque), il envoie une notification avec l'explication et l'action corrective.
Détecte automatiquement quand un jeu est lancé et passe le CPU et le GPU en mode performance maximale. Restaure le mode équilibré à la fin de la session. Envoie aussi des tips spécifiques au jeu détecté.
Surveille le kernel en temps réel (dmesg, journald). Détecte les signaux d'alerte avant un crash : throttling, GPU hung, undervoltage, lockup CPU, corruption mémoire. Alerte avec la cause et la solution.
Après chaque session gaming, analyse automatiquement les logs MangoHUD (.csv). Envoie un rapport avec les FPS moyens/min, les chutes détectées et des optimisations concrètes pour améliorer les perfs.
Quand un jeu plante (segfault, OOM, signal fatal, manque VRAM, reset GPU), il détecte l'événement dans les logs et envoie une notification expliquant la cause probable et 2 solutions pour l'éviter.
Quand tu lances un jeu Steam, interroge ProtonDB et AreWeAntiCheatYet et envoie une notification : tier de compatibilité (Platinum/Gold/Silver…), statut anti-cheat, verdict jouable ou non sur Linux.
Chaque semaine, génère un rapport gaming personnalisé : jeux joués, FPS moyen global, crashs détectés, recommandations IA pour la semaine suivante. Rapport sauvegardé dans
~/.local/share/shiva-logs/.
Services systemd
systemctl status shiva-repair shiva-gaming-optimizer shiva-bug-detector systemctl status shiva-fps-coach shiva-crash-reporter shiva-compatibility-scout
Atomic & rpm-ostree
ShivaOS is an immutable distribution. The root filesystem is read-only. This means the system cannot be broken by a bad update or misconfiguration.
Common commands
| Command | Description |
|---|---|
| rpm-ostree status | Show current and pending deployments |
| rpm-ostree upgrade | Download and stage latest update |
| rpm-ostree rollback | Revert to previous deployment |
| rpm-ostree install PKG | Install a package (layered) |
| rpm-ostree uninstall PKG | Remove a layered package |
Edition
ShivaOS uses KDE Plasma 6 as its desktop environment.
KDE Plasma 6 default
Full-featured, highly customizable desktop. Official image.quay.io/freuja/shivaos:latest
Installing apps
On an immutable system, the recommended way to install apps is Flatpak. System packages can be layered with rpm-ostree.
Flatpak (recommended)
flatpak install flathub com.example.App
Use Shiva Commander to browse and install Flatpak apps with a graphical interface.
rpm-ostree (system packages)
rpm-ostree install package-name systemctl reboot
Troubleshooting
Black screen on first boot (NVIDIA)
Wait 2–3 minutes. akmod-nvidia is compiling the kernel module. If it persists after a second reboot, run:
sudo akmods --force && sudo dracut --force
KDE freezes after screen lock
Set a hostname to fix a D-Bus context issue:
sudo hostnamectl set-hostname shivaos
Update failed / system broken
Roll back to the previous working deployment:
rpm-ostree rollback && systemctl reboot
Shiva AI returns 403 error
Check your internet connection. The AI uses a secure proxy at shivaos.com. If the issue persists, check that your system time is correct.
Game won't launch via Proton
Try switching to a different Proton version, or install Proton-GE from Shiva Commander. Add PROTON_LOG=1 %command% as launch option to see logs.
ShivaOS vs Other Gaming Distros
ShivaOS is the only Atomic gaming distro with built-in AI modules and dedicated GPU management tools.
| Feature | ShivaOS | Bazzite | CachyOS | Nobara | Garuda | SteamOS |
|---|