Linux: Install MADA Booth

Install Capture

1. Prepare the machineMinimal installation, working network connection, and an account with sudo privileges.
2. Download the packageDownload MADABooth2026.8.1.tar.gz and extract it:

   tar -xzf MADABooth2026.8.1.tar.gz
   sudo ./MADABooth/install.sh --url https://app.madabooth.nl/booth

3. Answer the questionsThe installation script asks for the booth address and screen orientation, then installs the kiosk, services, and udev rules.
4. Restartsudo reboot - the terminal automatically launches the booth in full-screen mode without a mouse pointer.
5. Connect the boothThe screen displays a pairing code. Enter it under Booths in the admin panel, or scan the QR code.

Options

Option	Description
--url <adres>	Booth address
--rotate left|right|inverted	Mount the screen in portrait orientation
--print-agent	Include CUPS right away for the photo printer
--yes	Skip all questions and use default values

What the installation script configures

• MADA Booth kiosk in full-screen mode, with camera access enabled by default
• Autostart via mada-booth.service with a dedicated user and password login disabled
• Watchdog that checks every 30 seconds and restarts the kiosk or machine if necessary
• Service running on 127.0.0.1:9120 for shutdown and restart commands from the service menu
• Automatic update every 12 hours, with checksum verification and rollback if issues occur
• Sleep mode, screen saver and graphical login disabled

Manage on the device

sudo nano /etc/madabooth/booth.conf        # adres, schermstand, poort
sudo systemctl restart mada-booth          # alleen de booth herstarten
journalctl -u mada-booth -f                # meekijken
sudo /opt/madabooth/update.sh --check      # beschikbare versie bekijken

Shut down and restart

Open the hidden service menu on the photo booth by tapping the top-left corner four times or Ctrl+Alt+S, enter the service code and select Restart or Shut Down under Terminal. Both start a five-second countdown that you can cancel.

Troubleshooting

Issue	Solution
Black screen after restarting	journalctl -u mada-booth -n 50 check it. The video driver is usually missing
Camera not found	Connect the camera before starting up and sudo systemctl restart mada-booth
Photo booth keeps restarting	Check the network or photo booth address in /etc/madabooth/booth.conf
Printer is not printing	Check CUPS at http://localhost:631 and verify the printer name in the admin panel