mkrieger/Wachalarm-Monitor
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
f484c83094
Wachalarm-Monitor/image-setup.md
Jarno Rantanen f484c83094 Add a missing sudo.
2016-09-04 13:05:58 +03:00

5.3 KiB
Raw Blame History

Image setup

Baseline setup

Replace $TAG with whatever version is being built, e.g. v1.2.

  1. Flash your SD card (assuming OS X):

    1. Get Ubuntu MATE 16.04 and decompress into an .img file
    2. $ diskutil list to check correct device
    3. $ diskutil unmountDisk /dev/disk2 to prepare it for imaging
    4. $ sudo dd bs=1m if=ubuntu-mate-16.04-desktop-armhf-raspberry-pi.img of=/dev/rdisk2 (will take a while)

  2. Boot your Raspberry Pi using the SD card (the setup should be done on a Pi 3, but the resulting image will work on Pi 2 as well)

  3. Answer basic questions (timezone, keyboard layout, default user, etc)

    1. Set hostname to chilipie-kiosk
    2. Set username/password to pi:raspberry (or whatever you want)
    3. Log in automatically after boot

  4. At this point you can already SSH onto the Pi and do the rest of the setup remotely

  5. $ sudo visudo and add pi ALL=(ALL) NOPASSWD: ALL to allow sudo without password prompt

  6. Disable MATE's default desktop with $ sudo graphical disable (though later nodm will boot directly to matchbox anyway)

  7. Clean up MATE's desktop cruft with $ rm -rf ~/*

  8. Remove some packages we don't need: $ sudo apt-get purge -y $(dpkg --get-selections 'sonic*' 'thunderbird*' 'libreoffice*' 'minecraft*' 'scratch*' 'shotwell*' 'simple-scan*' 'hexchat*' 'pidgin*' 'transmission*' 'youtube-dl*' 'atril*' 'idle*' 'brasero*' 'omxplayer*' 'rhythmbox*' 'supercollider*' 'vlc*' | cut -f 1 | tr '\n' ' ')

  9. Install some packages we'll need: $ sudo apt-get update && sudo apt-get install -y vim nodm matchbox-window-manager unclutter mailutils nitrogen jq

    • When mailutils prompts about its setup, "local only" is fine (we install mailutils so that you can check mail for cronjob output)

  10. For the time being, the Chromium from Ubuntu repo's keeps segfaulting, so use the alternate installation method instead of installing the chromium-browser package directly

  11. Remove unnecessary packages with $ sudo apt-get autoremove -y && sudo apt-get clean

  12. Make sure automatic software updates are disabled, in /etc/apt/apt.conf.d/10periodic:

     APT::Periodic::Unattended-Upgrade "0";
 APT::Periodic::Update-Package-Lists "0";
 APT::Periodic::Download-Upgradeable-Packages "0";
 APT::Periodic::AutocleanInterval "0";

  13. In /etc/default/nodm, set:

     NODM_ENABLED=true
 NODM_USER=pi
 NODM_FIRST_VT=8

  14. In /usr/share/plymouth/themes/ubuntu-mate-text/ubuntu-mate-text.plymouth, set:

     [ubuntu-text]
 title=chilipie-kiosk
 black=0x000000

  15. In /usr/share/plymouth/themes/ubuntu-mate-logo/ubuntu-mate-logo.script, set:

     Window.SetBackgroundTopColor (0, 0, 0);
 Window.SetBackgroundBottomColor (0, 0, 0);

  16. Replace the Plymouth theme logos with $ cd /usr/share/plymouth/themes/ubuntu-mate-logo && sudo rm ubuntu-mate-logo{,16}.png && sudo ln -s /home/pi/background.png ubuntu-mate-logo.png && sudo ln -s /home/pi/background.png ubuntu-mate-logo16.png

  17. Check that the version in .chilipie-kiosk-version matches $TAG, and it's on GitHub

  18. 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

  19. Put in the example crontab with $ crontab -e:

     # m h  dom mon dow   command

 # 0  7 * * 1-5 ~/display-on.sh  # turn display on weekdays at 7 AM
 # 0 19 * * 1-5 ~/display-off.sh # turn display off weekdays at 7 PM

  20. Disable overscan for HDMI output (as this is rarely needed on modern displays) by uncommenting disable_overscan=1 in /boot/config.txt

  21. Set up WiFi (for Raspberry Pi 3 only):

    1. Check the interface name with $ ifconfig, e.g. wlan0

    2. Append to /etc/network/interfaces:

      Internal WiFi adapter

      allow-hotplug wlan0 iface wlan0 inet dhcp wpa-conf /etc/wpa_supplicant/wpa_supplicant.conf iface default inet dhcp

    3. In /etc/wpa_supplicant/wpa_supplicant.conf:

      network={ ssid="networkname" psk="secretpassword" }

    4. Symlink the file, for convenience: $ ln -s /etc/wpa_supplicant/wpa_supplicant.conf wlan.conf

  22. Disable SSH access (because the default credentials aren't very secure): $ sudo systemctl disable ssh.service

  23. Reboot (should land you in Chromium)

  24. Tell Chromium "Don't ask again" about being the default browser

  25. Configure Chromium to start from "where you left off", and navigate to https://github.com/futurice/chilipie-kiosk/blob/$TAG/first-boot.md

  26. Unpower the Pi

Dumping the image

Assuming OS X:

  1. $ diskutil list to check correct device
  2. $ diskutil unmountDisk /dev/disk2 to prepare it for imaging
  3. $ sudo dd bs=1m count=7680 if=/dev/disk2 of=chilipie-kiosk-$TAG.img (only dump the relevant first ~8 GB, matching the original ubuntu-mate image size)
  4. $ openssl sha1 chilipie-kiosk-$TAG.img and include hash in release notes
  5. $ zip chilipie-kiosk-$TAG.img.zip chilipie-kiosk-$TAG.img