sites

public wiki contents of suckless.org
git clone git://git.suckless.org/sites
Log | Files | Refs

index.md (1929B)


      1 kiosk mode
      2 ==========
      3 
      4 Description
      5 -----------
      6 
      7 With these steps you can change your system into a kiosk mode terminal.
      8 Please note that you do not have any access to the system but the web
      9 browser. To undo the changes you need a rescue system.
     10 
     11 Software
     12 --------
     13 
     14 This software has to be installed on the system for my whoto to work:
     15 
     16 * 'lxdm' login manager
     17 * 'i3' window manager
     18 * 'surf' web browser
     19 
     20 Feel free to use other components if desired.
     21 
     22 Basic setup
     23 -----------
     24 
     25 We have to ensure that the basic system can not be altered, so we lock
     26 all user accounts ('root' and 'kiosk' in this example):
     27 
     28         passwd -l root
     29         passwd -l kiosk
     30 
     31 Additionally we create a file '/etc/X11/xorg.conf.d/15-no-vt.conf'.
     32 
     33         Section "ServerFlags"
     34                 Option  "DontVTSwitch"  "True"
     35         EndSection
     36 
     37 Now X.org does not allow to change to the virtual terminal via
     38 'Ctrl-Alt-F1'.
     39 
     40 Depending on your setup you may want to stop and disable services like
     41 ssh daemon and/or disable public key authentication.
     42 
     43 Login manager
     44 -------------
     45 
     46 As the accounts are locked we need to enable auto login in the login
     47 manager. To make sure the correct window manager is started we add this
     48 in '/etc/lxdm/lxdm.conf', too.
     49 
     50         autologin=kiosk
     51         session=i3
     52 
     53 Window manager
     54 --------------
     55 
     56 The window manager 'i3' is locked down to just start web browser 'surf'
     57 with parameter '-K' in fullscreen mode. All key strokes are disallowed,
     58 except Ctrl+Shift+C to poweroff the system (via 'systemd'). Save the
     59 following file to '/home/kiosk/.i3/config':
     60 
     61         set $mod Mod4
     62 
     63         # shut down system with systemd/polkit
     64         bindsym Control+Shift+C exec /usr/bin/systemctl poweroff
     65 
     66 	# make surf start in fullscreen
     67         for_window [class="Surf"] fullscreen
     68 
     69 	# execute surf
     70         exec /usr/bin/surf -K //surf.suckless.org/
     71 
     72 Now reboot your system and have fun. ;)
     73 
     74 Author
     75 ------
     76 
     77 * Christian Hesse <mail@eworm.de>