grubstation is a Go-based agent designed to manage bare-metal OS booting and selection via Home Assistant and Wake-on-LAN (WOL). It helps enable a user to remotely select an operating system for a specific host, send a wake on lan packet, and have the machine dynamically boot into the chosen OS.
After installation, whenever your server shuts down, grubstation will read the available boot options and push them to Home Assistant through a webhook. After selecting an option in Home Assistant, you can either press the "Wake" button or just power the machine on normally. It will then boot with your newly selected options.
| Type | Supported |
|---|---|
| Bootloaders | GRUB |
| Init Systems | systemd |
Requirements:
- Home Assistant
- Home Assistant Grubstation Integration
- Supported Bootloader and Init System (see above)
Recommended Installation:
- Download the latest pre-built package for your OS from the Releases Page.
- Install the package (e.g.,
sudo dpkg -i grubstation_*_amd64.deb). - Run the automated setup wizard to auto-detect and configure your network info, home assistant info, bootloader, and init system:
sudo grubstation setup
For advanced setups or manual configuration, please refer to the documentation: