Skip to content

Bootible

The missing first hour for Windows handhelds — one command sets the device up, the same command repairs it after updates.

A new Windows handheld greets you with the same three problems: it drains battery while it "sleeps", the recommended setup is a long checklist you work through by hand, and the next Windows update quietly reverts what you fixed. Bootible turns that first hour into one command — and the fix for every update after it into the same command.

Bootible automates the configuration of Steam Deck, ROG Ally, Android handhelds, and other gaming devices. Preview everything before applying (dry-run is the default), keep your config as YAML in your own private repo, and re-run anytime — drift from your known-good state is detected and repaired — and a repair is only reported after it's verified to have actually taken.

  • Getting Started


    Get your device configured in minutes with a single command.

    Get started

  • Config Basics


    Customize every aspect of your setup with simple YAML.

    Config Basics

  • Configure Your Device


    Game streaming, emulation, remote access, and more.

    Configure

  • 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, sleep-to-hibernate power fixes, optional G-Helper install, gaming optimizations, debloat options, and streaming tools. Prefer the latest changes from main? Use the beta channel: irm https://bootible.dev/rog-beta | iex. Both channels are served with checksum verification.

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

Android 11+ — Wireless ADB provisioning from your computer. Install APKs, configure settings, and push files to Retroid Pocket, AYANEO, Odin, and other Android handhelds.


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.
Re-runs Repair Drift
Run as many times as you want. On Windows, drift from your known-good state is detected and re-applied — repairs are reported only after post-run verification confirms them.
Receipt on the Desktop
Every Windows run writes "Bootible - Read Me.md" to the Desktop: apps installed, changes applied, and an FAQ.
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's Available

Curated defaults, full preview

The defaults are a curated gaming baseline — and the dry run shows you every change before anything is touched. Every item is a config key you can turn off, so your config only needs the overrides.

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.