Repository navigation
Install Native Wall
Kegwall can drive a wall screen two ways. Both render the same web wall (/wall/:slug, every
look/theme/takeover) — they differ only in the engine.
| Mode | Engine on the screen | Installer | Systemd unit |
|---|---|---|---|
| Chromium kiosk |
cage (Wayland) + chromium
|
pi-install.sh --kiosk |
kegwall-kiosk.service |
| Native |
cage + cog (WPE WebKit)
|
pi-install.sh --native-wall |
kegwall-wall.service |
The "native" client is cog, the WPE WebKit launcher. It renders
the exact same web wall as the chromium kiosk, but in the much lighter WPE engine instead of
Blink — smaller footprint, faster boot, no chromium update churn — with no second UI to
maintain (one web codebase powers every display). Works on both Raspberry Pi (arm64) and
amd64 mini-PCs / Intel NUCs.
Earlier previews explored a from-scratch flutter-pi Dart client (
apps/wall-native/). That path was shelved: it duplicated the entire wall UI in Dart for no rendering benefit over WPE. The Dart scaffold stays in-tree for reference but isn't wired to any installer.
One authoritative signal — the marker file the installers stamp:
cat /etc/kegwall/display-mode # → chromium | native | (absent = no managed display)
The server surfaces the same value for the admin/first-run wizard:
GET /api/system/urls → { ..., "displayMode": "chromium" | "native" | "none" }
And the systemd unit name is the belt-and-braces tell:
systemctl status kegwall-kiosk # chromium kiosk (cage + chromium)
systemctl status kegwall-wall # native cog / WPE
Fresh install, native from the start:
curl -fsSL https://raw.githubusercontent.com/dlommm/Kegwall/main/scripts/pi-install.sh | sudo bash -s -- --native-wallOr, on a box that already runs the server, point its screen at the native client:
sudo /opt/kegwall/scripts/native-wall-setup.sh --port 8080 --slug mainnative-wall-setup.sh flags: --port, --slug, --base-url (defaults to
http://localhost:<port>), --token (per-display token, appended as ?displayToken=…),
--url (full override), --force (skip the display-manager-disable confirmation).
-
apt install cog cage(WPE WebKit + the tiny kiosk compositor). - Creates the
kegwall-kioskseat user (shared with the chromium kiosk) invideo,render,input. - Installs
kegwall-wall.service—cage -d -- cog <wall url>on tty1, owning the screen via a logind seat, waiting for/api/healthfirst.cage -dhides the pointer; the wall CSS also setscursor: none, so no mouse shows. - Stamps
/etc/kegwall/display-mode = native.
It's fast — no compile, no SDK. If a desktop display manager (lightdm/gdm3/sddm) is enabled, it
asks before disabling it (or pass --force).
-
Restart the display: the admin UI's "Restart kiosk display" button works for native too (it
restarts whichever display unit is active). Over SSH:
sudo systemctl restart kegwall-wall. -
Repoint to a different wall/URL: re-run
native-wall-setup.sh --slug <slug>(or--url).
sudo systemctl disable --now kegwall-wall
sudo /opt/kegwall/scripts/pi-tablet-setup.sh --local --force "http://localhost:8080/wall/main"That re-stamps the marker to chromium.
sudo systemctl disable --now kegwall-wall
sudo rm -f /etc/systemd/system/kegwall-wall.service /etc/kegwall/display-mode
sudo systemctl enable --now getty@tty1-
Nothing on screen / cog exits:
journalctl -u kegwall-wall -f. The unit waits for/api/health, so a not-yet-ready server just delays start. -
cognot found after install: on some Debian releases the WPE runtime is split — also installlibwpewebkit-1.1-0and/orwpewebkit-driver. -
Mouse cursor visible: the wall page sets
cursor: none; if you're on an older build, add* { cursor: none !important; }to the wall's Custom CSS (Walls → edit).
Mirrored from docs/install/native-wall.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