# Image setup

## Baseline setup

Replace `$TAG` with whatever version is being built, e.g. `v2.0.0`.

1.  Check that the version in `.chilipie-kiosk-version` matches `$TAG`, and it's on GitHub
1.  Get Raspbian Lite (`2018-06-27-raspbian-stretch-lite.zip`)
1.  Flash it onto an SD card (use [Etcher](https://etcher.io) or `dd`)
1.  Re-mount the card
1.  Update the file `/Volumes/boot/cmdline.txt` on the card:
    ```diff
    -dwc_otg.lpm_enable=0 console=serial0,115200 console=tty1 root=PARTUUID=4d3ee428-02 rootfstype=ext4 elevator=deadline fsck.repair=yes rootwait quiet init=/usr/lib/raspi-config/init_resize.sh
    +dwc_otg.lpm_enable=0 console=serial0,115200 console=tty1 root=PARTUUID=4d3ee428-02 rootfstype=ext4 elevator=deadline fsck.repair=yes rootwait quiet
    ```
1.  Boot your Pi from the SD card
1.  Run `sudo raspi-config` and:
    1.  Set localization options
    1.  Set hostname to `chilipie-kiosk`
    1.  Join a WiFi (if wired network isn't available for setup)
    1.  Enable SSH
    1.  Set automatic CLI login after boot
1.  At this point you can already SSH onto the Pi and do the rest of the setup remotely
1.  [Resize the root partition](https://elinux.org/RPi_Resize_Flash_Partitions#Manually_resizing_the_SD_card_on_Raspberry_Pi) to make space for additional software
    1.  `sudo fdisk /dev/mmcblk0`
    1.  `p`
    1.  Make note of the "Start" value of the 2nd partition (e.g. `98304`)
    1.  `d`
    1.  `2`
    1.  `n`
    1.  `p`
    1.  `2`
    1.  For "First sector", enter the "Start" value from above (e.g. `98304`)
    1.  For "Last sector", enter `+3G`
    1.  If asked if you want to remove the existing "ext4" signature, say `y`
    1.  `w`
    1.  `sudo shutdown -r now`
    1.  `sudo resize2fs /dev/mmcblk0p2`
    1.  `df -h`
1.  Install some packages we'll need: `sudo apt-get update && sudo apt-get install -y vim matchbox-window-manager unclutter mailutils nitrogen jq chromium-browser xserver-xorg xinit rpd-plym-splash`
    -   If `nodm` prompts whether it should be enabled by default, say "yes"
    -   TODO TODO TODO: nodm NOT NEEDED ANYMORE?
    -   If mailutils prompts about its setup, "local only" is fine (we install mailutils so that you can check `mail` for cronjob output)
1.  Disable overscan (as it's rarely needed on modern displays) in `/boot/config.txt` with:
    ```diff
    -#disable_overscan=1
    +disable_overscan=1
    ```
1.  Get default scripts with `wget "https://github.com/futurice/chilipie-kiosk/archive/master.zip" && unzip master.zip && cp -v $(find chilipie-kiosk-master/home/ -type f) . && rm -rf chilipie-kiosk-master/ master.zip`
1.  [Customize Plymouth boot theme](https://scribles.net/customizing-boot-up-screen-on-raspberry-pi/):
    1.  `sudo cp background.png /usr/share/plymouth/themes/pix/splash.png`
    1.  In `/boot/config.txt`, append `disable_splash=1`
    1.  In `/boot/cmdline.txt`:
    ```diff
    -TODO
    +dwc_otg.lpm_enable=0 console=serial0,115200 console=tty3 root=PARTUUID=4d3ee428-02 rootfstype=ext4 elevator=deadline fsck.repair=yes rootwait quiet splash quiet plymouth.ignore-serial-consoles logo.nologo vt.global_cursor_default=0
    ```
1.  Put in the example crontab with `crontab crontab.example`
1.  Disable SSH access again (because the default credentials aren't very secure) with `sudo raspi-config`
1.  Reboot (should land you in Chromium)
1.  Tell Chromium "Don't ask again" about being the default browser
1.  Configure Chromium to start from "where you left off", and navigate to https://github.com/futurice/chilipie-kiosk/blob/$TAG/first-boot.md
1.  Unpower the Pi

## Dumping the image

Assuming OS X:

1.  `diskutil list` to check correct device
1.  `diskutil unmountDisk /dev/disk3` to prepare it for imaging
1.  `sudo dd bs=1m count=3500 if=/dev/disk3 of=chilipie-kiosk-$TAG.img` (only dump the relevant first ~4 GB; takes around 15 minutes)
1.  `COPYFILE_DISABLE=1 tar -zcvf chilipie-kiosk-$TAG.img.tar.gz chilipie-kiosk-$TAG.img`
1.  `openssl sha1 chilipie-kiosk-$TAG.img*` and include hash in release notes