Install Guide

Get HubOS running in 15 minutes.

1

Download the ISO

Choose the right variant for your hardware:

Desktop AMD or Intel GPU (integrated or dedicated) Download (~4 GB)
NVIDIA NVIDIA GPU (GTX 900 series or newer) Download (~4.5 GB)
Deck Steam Deck and handheld PCs Coming Soon
Not sure which GPU you have?
Windows: Right-click desktop → Display settings → Advanced display → GPU
Linux: Run lspci | grep VGA in terminal
2

Create a bootable USB

Write the ISO to a USB drive (8 GB minimum). Pick your tool:

Ventoy (Recommended)

Install Ventoy on USB once, then just copy ISO files onto it. Supports multiple ISOs.

ventoy.net

Rufus (Windows)

Simple USB writer for Windows. Select the ISO, pick your USB, click Start.

rufus.ie

dd (Linux/Mac)

Command line. Replace /dev/sdX with your USB device:

sudo dd if=hubos-desktop.iso of=/dev/sdX bs=4M status=progress oflag=sync
Warning: This will erase everything on the USB drive. Make sure you select the correct device.
3

Boot from USB

  1. Plug in the USB drive
  2. Restart your PC
  3. Press the boot menu key during startup:
    • Most PCs: F12, F8, or Esc
    • ASUS: F8
    • MSI/Gigabyte: F12
    • Dell: F12
    • HP: F9
    • Lenovo: F12
  4. Select your USB drive from the boot menu
Secure Boot: HubOS supports Secure Boot (inherited from Fedora). You do not need to disable it. If you have issues, try disabling it in BIOS as a troubleshooting step.
4

Install with Calamares

The HubOS installer will launch automatically. Follow the steps:

  1. Welcome: Select your language
  2. Location: Pick your timezone
  3. Keyboard: Choose your layout
  4. Partitioning:
    • Erase disk — Simplest option, uses the whole drive
    • Install alongside — Dual-boot with Windows/other OS
    • Manual — Advanced partitioning
  5. Users: Create your username and password
  6. Summary: Review and click Install
Recommended disk space: 50 GB minimum, 100 GB+ recommended (games need space)
5

First boot — you're in!

After installation and reboot:

  1. HubOS login screen appears — log in with your credentials
  2. The First-Boot Wizard launches automatically:
    • Detects your GPU and confirms drivers are working
    • Opens the 24HG Hub to create/link your account
    • Lets you pick gaming preferences (MangoHud, GameMode, etc.)
    • Deploys optimized game configs
  3. In the background, Steam, Lutris, Heroic, and Discord are being installed via Flatpak
  4. The 24HG Hub opens — browse servers, join chat, start gaming!

After installation

Useful commands

hubos-performance gamingSwitch to max performance mode
hubos-performance balancedBack to balanced mode
hubos-diagSystem diagnostics (share in Discord for support)
hubos-diag --pasteUpload diagnostics and get a shareable URL
connect-rustQuick-connect to 24HG Rust server
connect-cs2Quick-connect to 24HG CS2 server
hubos-updateCheck for and apply OS updates
hubos-rollbackRoll back to previous OS version

Keyboard shortcuts

F12Toggle MangoHud performance overlay (in games)
SuperOpen app launcher
Super + LLock screen

System updates

HubOS updates automatically every night. Updates are staged and apply on reboot. You'll get a notification when an update is ready. To update manually:

rpm-ostree upgrade && systemctl reboot

If something breaks, roll back instantly:

rpm-ostree rollback && systemctl reboot

System Requirements

CPU64-bit (x86_64) — Intel or AMD
RAM4 GB minimum, 8 GB+ recommended
Storage50 GB minimum, 100 GB+ recommended
GPUAMD, NVIDIA (GTX 900+), or Intel (UHD 600+)
USB8 GB+ for installer
InternetRequired for first-boot setup and Hub access