ROG Ally¶

Bootible uses PowerShell modules to configure your ROG Ally, installing applications via winget and applying Windows gaming optimizations.

Quick Start¶

1. Open PowerShell as Administrator¶

Press Win+X and select Terminal (Admin) or PowerShell (Admin).

2. Run Bootible¶

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

This runs a dry run first, showing what would change. Then run bootible to apply.

What Gets Installed¶

Gaming Platforms¶

Applications¶

System Optimizations¶

• Windows Game Mode
• Hardware-accelerated GPU Scheduling
• Game DVR/Xbox Game Bar control
• Telemetry reduction
• Classic right-click menu
• ASUS-specific tools

ROG Ally-Specific Tools¶

Enable in config:

install_rog_ally: true
install_handheld_companion: true
install_rtss: true
install_hwinfo: true

Windows Optimization¶

Gaming Tweaks¶

# Enable Windows Game Mode
enable_game_mode: true

# Hardware-accelerated GPU scheduling
enable_hardware_gpu_scheduling: true

# Disable Xbox Game Bar (less overhead)
disable_game_dvr: true
disable_xbox_gamebar: true

# Steam Big Picture on startup
configure_steam_autostart: true
steam_big_picture_mode: true

Privacy & Debloating¶

# Privacy settings
disable_telemetry: true
disable_activity_history: true
disable_location_tracking: true

# Remove Copilot
disable_copilot: true

# UI improvements
classic_right_click_menu: true
show_file_extensions: true
disable_lock_screen_ads: true
disable_bing_search: true

Performance¶

# Optional - security trade-off
disable_core_isolation: false  # Can improve game performance
disable_vbs: false             # Virtualization-Based Security

# Network
prefer_ipv4: true
disable_teredo: true

# Maintenance
enable_disk_cleanup: true
sync_time: true

Game Streaming¶

As a Client (Play from PC)¶

install_streaming: true
install_moonlight: true
install_chiaki: true
install_parsec: true
install_steam_link: true

As a Host (Stream to other devices)¶

install_sunshine: true  # Open-source Moonlight host
install_parsec: true    # Also works as host

Remote Access¶

SSH¶

Windows OpenSSH server for remote management:

install_ssh: true
ssh_server_enable: true
ssh_import_authorized_keys: true
ssh_authorized_keys:
  - "desktop.pub"  # From private/ssh-keys/

Tailscale¶

Access your ROG Ally from anywhere:

install_tailscale: true

RDP¶

Enable Windows Remote Desktop:

enable_rdp: true

Emulation¶

EmuDeck for Windows provides the same all-in-one emulation setup as on Steam Deck:

install_emulation: true

Post-Install:

1. Run EmuDeck from Desktop
2. Choose installation options
3. Copy ROMs to configured folder
4. Use Steam ROM Manager to add to Steam

Patreon/EA Version:

Place your download in:

private/scripts/EmuDeck EA Windows.bat

Network Configuration¶

Static IP¶

static_ip:
  enabled: true
  interface: "Ethernet"  # Or "Wi-Fi"
  address: "192.168.1.100"
  prefix_length: 24
  gateway: "192.168.1.1"
  dns:
    - "1.1.1.1"
    - "8.8.8.8"

Hostname¶

hostname: "vengeance"

Backup & Recovery¶

System Restore Points¶

Before making changes, Bootible creates a restore point.

To restore if something goes wrong:

1. Search Create a restore point in Start
2. Click System Restore
3. Select the Bootible restore point
4. Follow the wizard

Disable Restore Points¶

# Not recommended, but available
create_restore_point: false

Troubleshooting¶

Winget Not Working¶

1. Open Microsoft Store > Library > Update all
2. Search for "App Installer" and update it
3. Restart Terminal

Package Install Failed¶

Run dry-run to validate packages:

.\Run.ps1 -DryRun

Reset winget sources:

winget source reset --force

SSH Connection Refused¶

1. Check service: Get-Service sshd
2. Check firewall: Get-NetFirewallRule -DisplayName "*SSH*"
3. Start if needed: Start-Service sshd

Debloat Settings Not Applied¶

Some settings require logout/reboot. UCPD-protected registry keys use a scheduled task that runs at next login.

Armoury Crate Issues¶

Bootible doesn't modify Armoury Crate. For issues:

1. Update via MyASUS
2. Reinstall from ASUS support site
3. Check ROG Ally subreddit for known issues

Command Line Usage¶

Dry Run¶

.\Run.ps1 -DryRun

Real Run¶

.\Run.ps1

Specific Modules¶

# Only base and apps
.\Run.ps1 -Tags base,apps

# Skip debloat
.\Run.ps1 -SkipTags debloat

Verbose Output¶

.\Run.ps1 -Verbose

Next Steps¶