Repository navigation
Install Mini Pc
Kegwall runs natively on any amd64 mini PC (Intel NUC, Beelink, etc.) on Debian 13 ("trixie") — no Docker, no Pi required. The server is the same app that runs on a Raspberry Pi; only the host hardware differs.
Use a mini PC when you want more headroom than a Pi (more taps, BLE + cloud + analytics at once, faster rebuilds) or you already have an x86 box on hand.
Everything works the same except the Pi-only hardware sensors:
| Feature | Raspberry Pi | amd64 mini PC |
|---|---|---|
| CPU / RAM / disk / uptime | ✅ | ✅ |
| CPU temperature | ✅ thermal_zone0
|
✅ via coretemp (Intel) / k10temp (AMD) |
| Power draw (watts) | ✅ Pi 5 PMIC (whole-board) | ✅ RAPL (CPU-package power) |
| Undervoltage / throttle flags | ✅ vcgencmd
|
— not applicable (no PMIC); the panel reads "unavailable" |
| App self-update, OS apt update, UI reboot | ✅ | ✅ (same systemd units) |
| Kiosk mode (cage + chromium) | ✅ | ✅ |
Native wall client (cog / WPE, --native-wall) |
✅ | ✅ — lighter than chromium |
Tonight's This server row and the analytics Server tab both degrade gracefully: CPU/RAM/disk/temp/watts show real numbers; the undervoltage panel just says it's unavailable on x86.
Fresh Debian 13 amd64, then:
curl -fsSL https://raw.githubusercontent.com/dlommm/Kegwall/main/scripts/pi-install.sh | sudo bash(The script is arch-agnostic — it detects the amd64 host and installs natively. From a
local checkout you can also run sudo bash scripts/install.sh, a symlink to the same
script.) It installs Node 24 (NodeSource), a kegwall system user, the app at its latest
release tag, and the systemd units (kegwall.service + the app-update / OS-update / reboot
path units). Answer the prompts (install dir, port, BLE fallback, kiosk vs server mode, OS
updates) or pass the flags — see the Raspberry Pi guide for the full flag
list and the systemd/OS-update details, which are identical here. If this mini PC also drives a
screen, kiosk mode offers chromium (default) or the lighter native cog/WPE client
(--native-wall) — see native-wall.md.
Then open http://<mini-pc-ip>:<port> and run the first-run wizard.
-
Debian 13 (trixie): NodeSource
setup_24.xsupports trixie; the install toolchain (python3 make g++) buildsbetter-sqlite3if a prebuilt binary isn't available for your glibc. - RAPL watts need two samples to compute a rate, so the watts figure on Tonight appears from the second stats poll onward (a few seconds after boot).
-
BLE: pass
--with-bleif you're using Gen 1 / Pro BLE transports; it installsbluez, powers the adapter on (and sets BlueZAutoEnable=trueso it survives reboots — some NUCs ship it off), and grants the server thecap_net_rawcapability it needs to open a raw HCI socket. A USB Bluetooth dongle works on a mini PC that has none built in.- The unattended installer ISO and the default prompts install without BLE. If the
admin shows
WAITING FOR BLUETOOTH ADAPTER (STATE: POWEREDOFF), enable it after the fact — either re-run the installer with--with-ble, or manually:sudo apt-get install -y bluetooth bluez libbluetooth-dev sudo rfkill unblock bluetooth sudo systemctl enable --now bluetooth sudo bluetoothctl power on sudo setcap cap_net_raw+eip "$(readlink -f "$(command -v node)")" sudo systemctl restart kegwall
- The unattended installer ISO and the default prompts install without BLE. If the
admin shows
Mirrored from docs/install/mini-pc.md. Edit the repo copy; this page is regenerated from it.
- Admin Dashboard
- Beers
- Cleaning And Pours
- Customization
- Insights
- Install Android Tablet
- Install Display Agent
- Install Docker
- Install Esp32 Gen1
- Install Mini Pc
- Install Moving To Github
- Install Native Wall
- Install Raspberry Pi
- Install Unattended Debian
- Kegtron Pro Ble Format
- Menu And Kiosk
- People
- Recovery
- Settings
- Setup Face Sign In
- Setup Home Assistant
- Setup Kegtron Cloud
- Setup Motion Sensors
- Suppliers
- Taps And Kegs