|
|
@@ -0,0 +1,46 @@
|
|
|
+# Basic Kiosk Installer
|
|
|
+A really basic Bash script that helps you display one or multiple websites Kiosk style on Debian based distros.
|
|
|
+
|
|
|
+## Requirements
|
|
|
+What you need
|
|
|
+
|
|
|
+- Option 1 : Debian 12
|
|
|
+ - Base Installation with following :
|
|
|
+ - Locale set to your locale
|
|
|
+ - Hostename set to something appropriate
|
|
|
+ - Password for root set
|
|
|
+ - "kiosk" user made
|
|
|
+ - Software selection : SSH Server and Standard System Utilities (nothing more than that)
|
|
|
+
|
|
|
+- Option 2 : Raspberry Pi OS Lite
|
|
|
+ - Base Image with following :
|
|
|
+ - Network Configured
|
|
|
+ - Locale set to your locale
|
|
|
+ - Hostename set to something appropriate
|
|
|
+ - "kiosk" user made
|
|
|
+ - SSH Enabled
|
|
|
+
|
|
|
+## Debian 12
|
|
|
+
|
|
|
+### Basic user setup and preparations
|
|
|
+1. sign in to your Debian machine using SSH and kiosk user `ssh kiosk@your.debian.host`
|
|
|
+2. sign into your root account using `su`
|
|
|
+3. install the basics : `apt update && apt upgrade -y && apt install sudo dialog git htop tmux screen screenfetch -y`
|
|
|
+4. add sbin to bash paths for root `echo 'export PATH=$PATH:/sbin:/usr/sbin' | tee -a ~/.bashrc ~/.profile > /dev/null && bash`
|
|
|
+5. Add kiosk user to sudo group
|
|
|
+```bash
|
|
|
+bash
|
|
|
+usermod -aG sudo kiosk
|
|
|
+exit
|
|
|
+exit
|
|
|
+exit
|
|
|
+```
|
|
|
+6. Sign back in via ssh `ssh kiosk@your.debian.host`
|
|
|
+7. add sbin to bash paths for kiosk user `echo 'export PATH=$PATH:/sbin:/usr/sbin' | tee -a ~/.bashrc ~/.profile > /dev/null && bash`
|
|
|
+8. download the kiosk and go to its folder `git clone https://git.teleco.ch/crt/basic-kiosk.git/ && cd basic-kiosk`
|
|
|
+
|
|
|
+### Installing the Kiosk via Terminal User Interface (TUI/GUI)
|
|
|
+1. run the installer
|
|
|
+
|
|
|
+
|
|
|
+
|