AccountosDeployAsteriskMySQL

CCP Kiosk Setup - Lubuntu 24 LTS

Table of contents

1. Base System Setup
2. Rename NIC & Disable IPv6 and splash
3. Configure WiFi
4. Configure Autologin
5. Disable Crash Reporting
6. Disable Screen Lock
7. Image Management

Base System Setup

Rename NIC & Disable IPv6 and splash

sed -i s,GRUB_CMDLINE_LINUX='""',GRUB_CMDLINE_LINUX='"net.ifnames=0 biosdevname=0"',g /etc/default/grub

sed -i s,'GRUB_CMDLINE_LINUX_DEFAULT="splash"','GRUB_CMDLINE_LINUX_DEFAULT="ipv6.disable=1"',g /etc/default/grub

sudo update-grub

grub-mkconfig -o /boot/grub/grub.cfg

reboot

Configure Autologin

1. Lubuntu

   cat << eot > /etc/sddm.conf
   [Autologin]
   Relogin=false
   User=kiosk
   Session=Lubuntu
   # Xfce session
   Session=xfce
   eot
   

   Reference
2. LightDM

   cat << eot > /etc/lightdm/lightdm.conf
   [SeatDefaults]
   autologin-user=kiosk
   autologin-user-timeout=0
   user-session=xfce
   eot
   

3. Start xfce4 manually

   cat << eot >> /home/kiosk/.profile
   
   # Start GUI
   if [ $(tty) == "/dev/tty1" ]
   then
           exec /usr/bin/startxfce4
   fi
   eot
   

Configure WiFi

cat << eot > /etc/netplan/wifi.yaml
network:
  version: 2
  wifis:
    wifi0:
      match:
        name: "wlan0"
      dhcp4: true
      access-points:
        "WAP01":
          auth:
            key-management: "psk"
            password: "xxxxx"
          networkmanager:
            passthrough:
              ipv6.method: "disabled"
              #connection.permissions: "user:kiosk:;"
eot

Configure panel layout and items

1. Backup default configuration

   mv /etc/xdg/xfce4/panel/default.xml /etc/xdg/xfce4/panel/default.xml.orig
   

2. Create custom panel layout configuration xml file

   nano /etc/xdg/xfce4/panel/default.xml
   

   Paste the following content and save the file

   <?xml version="1.0" encoding="UTF-8"?>
   <channel name="xfce4-panel" version="1.0">
   <!-- Locked down panel -->
   <!--<channel name="xfce4-panel" version="1.0" locked="*" unlocked="root">-->
     <property name="configver" type="int" value="2"/>
     <property name="panels" type="array">
       <value type="int" value="1"/>
       <value type="int" value="2"/>
       <property name="dark-mode" type="bool" value="true"/>
       <property name="panel-1" type="empty">
         <property name="position" type="string" value="p=6;x=0;y=0"/>
         <property name="length" type="uint" value="100"/>
         <property name="position-locked" type="bool" value="true"/>
         <property name="icon-size" type="uint" value="16"/>
         <property name="size" type="uint" value="26"/>
         <property name="plugin-ids" type="array">
           <value type="int" value="1"/>
           <value type="int" value="2"/>
           <value type="int" value="3"/>
           <value type="int" value="4"/>
           <value type="int" value="5"/>
           <value type="int" value="6"/>
           <value type="int" value="7"/>
           <value type="int" value="8"/>
           <value type="int" value="9"/>
           <value type="int" value="10"/>
           <value type="int" value="11"/>
           <value type="int" value="12"/>
           <value type="int" value="13"/>
           <value type="int" value="14"/>
         </property>
       </property>
   <property name="panel-2" type="empty">
         <property name="autohide-behavior" type="uint" value="0"/>
         <property name="position" type="string" value="p=10;x=0;y=0"/>
         <property name="length" type="uint" value="1"/>
         <property name="position-locked" type="bool" value="true"/>
         <property name="size" type="uint" value="40"/>
         <property name="plugin-ids" type="array">
           <value type="int" value="15"/>
           <value type="int" value="16"/>
           <value type="int" value="17"/>
           <value type="int" value="18"/>
           <value type="int" value="19"/>
           <value type="int" value="20"/>
           <value type="int" value="21"/>
           <value type="int" value="22"/>
           <value type="int" value="23"/>
           <value type="int" value="24"/>
         </property>
       </property>
     </property>
     <property name="plugins" type="empty">  
       <property name="plugin-2" type="string" value="tasklist">
         <property name="grouping" type="uint" value="1"/>
         <property name="show-handle" type="bool" value="false"/>
       </property>
       <property name="plugin-3" type="string" value="separator">
         <property name="expand" type="bool" value="true"/>
         <property name="style" type="uint" value="0"/>
       </property>
       <!--<property name="plugin-4" type="string" value="pager"/>-->
       <property name="plugin-5" type="string" value="separator">
           <property name="style" type="uint" value="0"/>
       </property>
       <property name="plugin-6" type="string" value="systray">
           <property name="square-icons" type="bool" value="true"/>
       </property>
       <property name="plugin-8" type="string" value="pulseaudio">
         <property name="enable-keyboard-shortcuts" type="bool" value="true"/>
         <property name="show-notifications" type="bool" value="true"/>
       </property>
       <property name="plugin-9" type="string" value="power-manager-plugin"/>
       <property name="plugin-10" type="string" value="notification-plugin"/>
       <property name="plugin-11" type="string" value="separator">
         <property name="style" type="uint" value="0"/>
       </property>
       <property name="plugin-13" type="string" value="separator">
         <property name="style" type="uint" value="0"/>
       </property>
       <property name="plugin-15" type="string" value="showdesktop"/>
       <property name="plugin-16" type="string" value="separator"/>
       <property name="plugin-17" type="string" value="launcher">
         <property name="items" type="array">        
           <value type="string" value="utube_utube.desktop"/>
         </property>
       </property>
       <property name="plugin-18" type="string" value="separator"/>
       <property name="plugin-19" type="string" value="launcher">
         <property name="items" type="array">        
           <value type="string" value="org.gnome.Calculator.desktop"/>
         </property>
       </property>
   <property name="plugin-20" type="string" value="separator"/>
      <property name="plugin-21" type="string" value="clock">
         <property name="mode" type="uint" value="4"/>
         <property name="show-seconds" type="bool" value="true"/>
         <property name="show-meridiem" type="bool" value="false"/>
         <property name="tooltip-format" type="string" value="%A %d %B %Y"/>
         <property name="show-military" type="bool" value="false"/>
      </property>
       <property name="plugin-22" type="string" value="separator"/>
       <property name="plugin-23" type="string" value="actions">
         <property name="items" type="array">
           <value type="string" value="-lock-screen"/>
           <value type="string" value="-switch-user"/>
           <value type="string" value="-separator"/>
           <value type="string" value="-suspend"/>
           <value type="string" value="-hibernate"/>
           <value type="string" value="-hybrid-sleep"/>
           <value type="string" value="+restart"/>
           <value type="string" value="-separator"/>
           <value type="string" value="+shutdown"/>
           <value type="string" value="-separator"/>
           <value type="string" value="-logout"/>
           <value type="string" value="+logout-dialog"/>
         </property>
         <property name="appearance" type="uint" value="0"/>
       </property>
     </property>
   </channel>
   
   

3. Create default desktop layout configuration xml file

   nano /etc/xdg/xfce4/xfconf/xfce-perchannel-xml/xfce4-desktop.xml
   

   Paste the following content and save the file

   <?xml version="1.0" encoding="UTF-8"?>
   <channel name="xfce4-desktop" version="1.0">
   <!-- desktop icons display settings -->
     <property name="desktop-icons" type="empty">
       <property name="style" type="int" value="1"/>
         <property name="file-icons" type="empty">
         <property name="show-home" type="bool" value="false"/>
         <property name="show-filesystem" type="bool" value="false"/>
         <property name="show-trash" type="bool" value="false"/>
         <property name="show-removable" type="bool" value="false"/>
         <property name="show-network-removable" type="bool" value="false"/>
         <property name="show-device-removable" type="bool" value="false"/>
         <property name="show-unknown-removable" type="bool" value="false"/>
       </property>
     </property>
   <!-- disable desktop context menu -->
    <property name="desktop-menu" type="empty">
       <property name="show" type="bool" value="false"/>
     </property>
     <!-- hide top panel, we dont want to hide so we are going to comment it out -->
     <!--
     <property name="windowlist-menu" type="empty">
       <property name="show-add-remove-workspaces" type="bool" value="false"/>
     </property>
     -->
   </channel>
   
   

cp /usr/share/backgrounds/greybird.svg /usr/share/backgrounds/xfce/xfce-shapes.svg

Image Management

1. Partclone.dd without compression

   partclone.dd -N -d -s /dev/sda -O /mnt/test.img
   

2. Partclone.dd with compression [0-9]

   mkfifo /tmp/pigz1
   pigz -p $cores -8 < /tmp/pigz1 > /mnt/test.img & partclone.dd -N -d -s /dev/sda -O /tmp/pigz1
   

1. Partclone.dd without compression

   partclone.dd -N -d -s /mnt/test.img -o /dev/sda
   

2. Partclone.dd with compression

   gunzip -d -c < /mnt/test.img | partclone.dd -N -d -o /dev/sda
   

Disable Crash Reporting

sed -i s,'enabled=1','enabled=0',g /etc/default/apport

Disable Screen Lock

sed -i s,'Exec=light-locker','#Exec=light-locker',g /etc/xdg/autostart/light-locker.desktop