BarutuBarutu

Install Barutu on Raspberry Pi 3/4/5

Turn your Raspberry Pi 3, 4, or 5 into a dedicated Barutu display that auto-launches in kiosk mode and pairs to your account.

🚀 Quick Install (Recommended)

curl -fsSL barutu.app/api/pi | sudo bash

This one-liner works on all Pi 3/4/5 models with Raspberry Pi OS.

Option A: One-line install on Raspberry Pi OS

  1. Flash Raspberry Pi OS (Bookworm) using Raspberry Pi Imager. Optionally set Wi‑Fi and SSH in Advanced.
  2. Boot the Pi and open a terminal.
  3. Run the installer:
    curl -fsSL barutu.app/api/pi | sudo bash

    Or download first: curl -fsSL barutu.app/api/pi -o install.sh && sudo bash install.sh

  4. The device will auto-start kiosk on boot and open the Barutu pairing screen.
Or download directly: barutu-pi-install.sh

Option B: Flash a prebuilt image

Build a branded image using Docker (macOS/Linux/WSL). This produces a flashable image for Raspberry Pi Imager that boots straight into Barutu kiosk mode.

cd raspberry-pi/image
docker build -t barutu-pigen .
mkdir -p dist
docker run --rm -it -v $(pwd)/dist:/output barutu-pigen

Output: raspberry-pi/image/dist/ contains a .img/.zip ready for Raspberry Pi Imager (Custom Image).

Pairing your display

  1. On the Pi screen, you should see a pairing code at /display.
  2. In Barutu, go to Displays → Add Display and enter the code.

Manage auto-start and service

The installer sets up an Openbox autostart and a systemd service to launch kiosk at boot.

sudo systemctl status barutu-kiosk.service
sudo systemctl restart barutu-kiosk.service
sudo systemctl disable barutu-kiosk.service

Troubleshooting

  • If Chromium is missing, the installer attempts to install chromium-browser or chromium.
  • Ensure network time and connectivity are correct for TLS to load https://barutu.app.
  • Disable screen blanking and power saving are applied via Openbox autostart.
Barutu