configure role to deploy kiosk

README.md

@@ -1,3 +1,13 @@
-# raspberrypi-kiosk
+# ansible-raspberrypi-kiosk
 
-Ansible role to setup a raspberry pi in kiosk mode
+Ansible role to setup a Raspberry Pi in kiosk mode
+
+## Deploy
+
+1. Go to the [download page for the OS](https://www.raspberrypi.com/software/) and grab the **lite** version of the Raspberry Pi OS. Flash the OS on the SD card.
+2. Insert the SD card in your Raspberry Pi, boot it, and go through the first-time-setup. Use `pi` as the username and `raspberry` as the password
+3. Login and run `sudo systemctl enable ssh.service` to start the ssh server on boot.
+4. If desired, `sudo raspi-config` and apply overclock and/or tweak the size of the swap.
+5. Reboot your Raspberry Pi.
+6. On your main machine, run `ansible-playbook site.yaml -i hosts` at the root of this repository. This can be very slow depending on the model of your Pi.
+7. Once the playbook has finished running, your Raspberry Pi will reboot in kiosk mode.

hosts

@@ -1,2 +1,2 @@
 [raspberrypi-kiosk]
-raspberry ansible_become=true ansible_become_method=sudo ansible_become_user=root
+raspberrypi.local ansible_user=pi ansible_password=raspberry ansible_become_method=sudo ansible_become_user=root

roles/raspberrypi-kiosk/defaults/main.yaml

@@ -0,0 +1 @@
+kiosk_url: https://floatingqrcode.com/

roles/raspberrypi-kiosk/handlers/main.yaml

@@ -0,0 +1,2 @@
+- name: Reboot
+  reboot:

roles/raspberrypi-kiosk/tasks/main.yaml

@@ -0,0 +1,17 @@
+- name: Install Cage window manager and Midori browser
+  apt:
+    update_cache: yes
+    name:
+      - cage
+      - xwayland
+      - gtk3-nocsd
+      - midori
+
+- name: Configure autologin
+  command: raspi-config nonint do_boot_behaviour B2
+
+- name: Install kiosk script
+  template:
+    src: kiosk.sh.j2
+    dest: /etc/profile.d/kiosk.sh
+  notify: Reboot

roles/raspberrypi-kiosk/templates/kiosk.sh.j2

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+if [ "$(tty)" = "/dev/tty1" ]; then
+    while true; do
+        GTK_CSD=0 cage -d -s -- midori -e fullscreen -a {{ kiosk_url }}
+        sleep 1
+    done
+fi

site.yaml

@@ -1,10 +1,12 @@
 - hosts: all
+  become: true
   tasks:
     - name: Perform system update
       apt:
         update_cache: true
-        upgrade: true
+        upgrade: dist
 
 - hosts: all
+  become: true
   roles:
     - raspberrypi-kiosk