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.
-
Config Basics
Customize every aspect of your setup with simple YAML.
-
Configure Your Device
Game streaming, emulation, remote access, and more.
-
Reference
Complete documentation for every option and command.
Supported Devices¶
SteamOS / Arch Linux — Ansible-based configuration with Flatpak apps, Decky plugins, emulation, and more.
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.
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] - Dry Run by Default — First run previews all changes without applying them
- Review — See exactly what will be installed and configured
- Logs Pushed — Run logs are always pushed to your private repo
- Apply — Run
bootibleto 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.
-
Discord
Chat with other users and get help.
License¶
Bootible is open source software licensed under the MIT License.