GopherProxy

	index.md - 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 <[email protected]>