Portal for the Raspberry Pi

Setting up a Kiosk

  1. Install Raspbian lite, 64-bit.
  2. Create a new user named kiosk.
  3. Run raspi-config and set Boot Options > Desktop CLI > Console Autologin.
  4. Run apt-get update && apt-get upgrade to update all preinstalled packages.

Here you should configure your networking the way you want it. In some cases, it may be beneficial to setup a static IP. However, unless configured otherwise, the client script will automatically report its own local and public address to the Portal Devices server periodicially, keeping it up to date and in sync with any changes that may be caused by dynamic address assignment.

To set a static IP:

  1. Open /etc/dhcpcd.conf in your editor of choice.

  2. Configure these fields, according to your own needs:

    interface wlan0
static_routers=192.168.0.1
static domain_name_servers=192.168.0.1 1.1.1.1 8.8.8.8
static ip_address=192.168.0.10/24

  3. Save the file and reboot or restart the dhcpcd service.

  4. After networking is configured, enable SSH. (you can then continue setup over SSH)

  5. Install the packages openbox, xserver-xorg, xprintidle, and chromium-browser.

  6. Clone the portal-rpi to the kiosk user's home directory.

  7. Run sudo python3 portal.py -install to install the portal-gui and portal services.

  8. Now, open ~/.bash_profile and input the following: [[ -z $DISPLAY && $XDG_VTNR -eq 1 ]] && startx -- -nocursor

That should be all that's required to get up and running.