Repository navigation
Install Android Tablet
A tiny Android app (see android/) that runs your wall's
tablet page — /tablet/<wall-slug> — as a true kiosk: fullscreen, screen always on,
auto-reconnecting when the server restarts. It works for /wall/<slug> on an Android
TV stick too.
Every release attaches it: download kegwall-tablet.apk from the
latest release — or directly from
https://github.com/dlommm/Kegwall/releases/latest/download/kegwall-tablet.apk. (For a
branch test build, run the Publish workflow from the Actions tab with no tag; the
APK lands as a workflow artifact.)
- Copy the APK to the tablet (USB, a file-share, or just open the release download URL above in the tablet's browser).
- Open the APK from the Files app. Android will ask to allow installs from that source ("Install unknown apps") — allow it for the Files app/browser you used.
- Launch Kegwall, enter your tablet URL (e.g.
http://192.168.1.50:8080/tablet/main), tap Start kiosk.
Change the URL later: tap the top-left corner of the screen 5 times within 3 seconds.
If you use face sign-in, the app requests the Android camera permission on first launch — a normal system permission dialog, grant it there. If you deny it (or the tablet has no camera at all), the tablet page just falls back to the normal avatar grid; nothing crashes and face sign-in is simply unavailable. If you change your mind later, grant it from Android's own Settings → Apps → Kegwall → Permissions → Camera; no reinstall needed.
- Screen pinning (Settings → Security → App pinning): pin Kegwall so Home/Recents gestures don't leave the kiosk. Unpin needs the lock PIN.
- Plug the tablet in — the app keeps the screen on, which eats battery otherwise.
- Optional: set Kegwall as the launcher via any "kiosk launcher" app if the tablet is fully dedicated.
Without a signing key, CI produces only branch test builds — debug-signed APKs whose signature changes every build, so Android refuses to install an update over the old one — uninstall Kegwall first, then install the new APK. (Your saved URL is lost on uninstall; it's one field.)
To make updates install over the top, set up a signing key once:
keytool -genkeypair -v -keystore kegwall-kiosk.keystore -alias kegwall \
-keyalg RSA -keysize 2048 -validity 10000
base64 -i kegwall-kiosk.keystore | pbcopy # macOS; use `base64 -w0` on LinuxThen add four repository secrets on GitHub (Settings → Secrets and variables →
Actions → New repository secret): ANDROID_KEYSTORE_B64 (the base64 you just copied),
ANDROID_KEYSTORE_PASS, ANDROID_KEY_ALIAS (kegwall), ANDROID_KEY_PASS. From the
next build on, the job produces (and every release requires) a release-signed APK with a stable signature. Keep the
keystore file safe — losing it means one final uninstall/reinstall cycle with a new
key.
- The app allows plain-HTTP on purpose (
usesCleartextTraffic) — Kegwall is a LAN-first, no-TLS-by-design server (see docker.md). - Nothing app-specific is native: it's the same web tablet page, so features arrive with normal server updates — the APK only needs updating if the shell itself changes.
Mirrored from docs/install/android-tablet.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