index.md - sites - public wiki contents of suckless.org
 (HTM) git clone git://git.suckless.org/sites
 (DIR) Log
 (DIR) Files
 (DIR) 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>