Manual Kiosk Customization


In order to make changes to Porteus Kiosk operating system you have to extract the ISO, add/remove/modify the files, and rebuild the ISO using the "make_iso.sh" script provided with the Porteus Kiosk ISO. If you wish to accommodate installations to flash drives and hard drives rather than CD or DVD discs, you also need to run the 'isohybrid' command against the produced ISO to convert it to the 'hybrid' format.


NOTE: system partition is limited to 900 MB by default so please make sure that your customized ISO is not larger otherwise installation will fail. If you are planning to host offline webpage in kiosk with many large files the please follow this Q/A.


Unpack the installaiton ISO

Please run the following commands as user root to unpack the ISO to the /tmp/kiosk_ISO folder:

    mkdir /tmp/kiosk_ISO

    mount -o loop kiosk.iso /mnt/cdrom

    cp -a /mnt/cdrom/* /tmp/kiosk_ISO

    umount /mnt/cdrom


Add a new module to the ISO

Firstly, You have to create your module. Please check out this guide for instructions.
Once your custom module is ready you have to put it in the /xzm folder and create new kiosk ISO:

    mv module.xzm /tmp/kiosk_ISO/xzm

    cd /tmp/kiosk_ISO

    bash make_iso.sh


Burn the ISO on non-optical storage media

In the case that you want to burn the kiosk on usb stick or hard drive then you have to convert it to the 'hybrid' ISO format. Please install 'syslinux' (or 'isolinux') package on your favorite linux distribution and issue following command:

    isohybrid /tmp/Porteus-Kiosk.iso

When remastering a UEFI enabled ISO please run isohybrid with the '-u' flag:

    isohybrid -u /tmp/Porteus-Kiosk.iso

The only remaining step is to burn the ISO with the help of the 'dd' utility:

    dd if=Porteus-Kiosk.iso of=/dev/sdb

where '/dev/sdb' is the target device. Please note that this will overwrite the Master Boot Record on this device, so any existing operating systems on this device will no longer boot and Porteus Kiosk will take over whole device.