aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: d0173771f74869e61c4a0fcb64b37afa9733bc1e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
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
usermod -aG sudo kiosk
exit
exit
exit
  1. Sign back in via ssh ssh kiosk@your.debian.host
  2. add sbin to bash paths for kiosk user echo 'export PATH=$PATH:/sbin:/usr/sbin' | tee -a ~/.bashrc ~/.profile > /dev/null && bash
  3. 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