Skip to content

Bootible

One-liner setup for gaming handhelds.

Bootible automates the configuration of Steam Deck, ROG Ally X, and other gaming devices with a single command. Preview everything before applying, customize via your own private config, and re-run anytime to sync your setup.

  • Quick Start

    Get your device configured in minutes with a single command.

    Get started

  • Configuration

    Customize every aspect of your setup with simple YAML.

    Configure

  • Features

    Game streaming, emulation, remote access, and more.

    Explore features

  • Reference

    Complete documentation for every option and command.

    Read the docs

Supported Devices

curl -fsSL https://bootible.dev/deck | bash

SteamOS / Arch Linux — Ansible-based configuration with Flatpak apps, Decky plugins, emulation, and more.

irm https://bootible.dev/rog | iex

Windows 11 — PowerShell-based setup with winget packages, gaming optimizations, debloat options, and streaming tools.

How It Works

graph LR
    A[Run Command] --> B{First Run?}
    B -->|Yes| C[Dry Run Preview]
    C --> D[Review Output]
    D --> E[Push Logs]
    E --> F[Run bootible to Apply]
    B -->|No| G[Apply Changes]
    G --> H[Push Logs]
  1. Dry Run by Default — First run previews all changes without applying them
  2. Review — See exactly what will be installed and configured
  3. Logs Pushed — Run logs are always pushed to your private repo
  4. Apply — Run bootible to apply your configuration

Key Features

Safe by Default
Runs in preview mode first. Creates restore points (Windows) and btrfs snapshots (Steam Deck) before making changes.
Private Configuration
Your settings live in your own GitHub repo. No data is collected or stored.
Idempotent
Run as many times as you want. Only changes what's needed.
Multi-Device
Manage multiple devices from a single private config repo.
Batteries Included
100+ apps and tools available. Streaming, emulation, password managers, and more.
Open Source
MIT licensed. Audit the code, fork it, contribute back.

What Gets Installed

Everything is opt-in

Nothing is installed unless you enable it in your configuration.

Applications

Category Examples
Communication Discord, Signal, Telegram, Slack
Media Spotify, VLC, Plex, Jellyfin
Browsers Firefox, Chrome, Chromium
Productivity VS Code, OBS, LibreOffice
Gaming Steam, GOG Galaxy, Epic, Playnite
Streaming Moonlight, Chiaki, Parsec, Greenlight
Emulation EmuDeck, RetroArch, standalone emulators
Utilities 7-Zip, Everything, PowerToys

System Configuration

Feature Windows Steam Deck
Restore points / Snapshots
Static IP configuration
SSH server & key management
Tailscale VPN
Gaming optimizations
Debloat & privacy —
Decky Loader & plugins —

Community

  • GitHub

    Report issues, request features, and contribute.

    Repository

  • Discord

    Chat with other users and get help.

    Join Discord

License

Bootible is open source software licensed under the MIT License.