Skip to content

1.1 Raspbian OS with Docker

Eugen Mayer edited this page Jan 11, 2018 · 12 revisions

Install the vanilla raspbian image

  1. Download the raspbian lite image from the official site or you the latest image direct download link
  2. Put it on your SD card like sudo dd if=2016-11-25-raspbian-jessie-lite.img of=/dev/disk2 - be sure to change /dev/disk2 to your USB-Device name ( /dev/sdb or whatever ) and if needed, then image name, depending on when you downloaded it.

We follow the very basic official installation guide - check it out yourself, if you need more detailed explanation / examples.

First boot: password/sshd/firmware

  1. Put the SD drive into your RPI, connect HDMI since we do not have shell access yet
  2. Boot the RPI, login using user: pi and password: raspberry
  3. Change your password using passwd pi to be able to better remember your password
  4. Enter sudo raspi-config in the terminal, no go to Advanced Options and then select Update
  5. After the tool updated, run sudo raspi-config again, now move on with then next point
  6. Select Interface Options, then navigate to SSH, press Enter and select Enable or disable ssh server - official guide, slightly outdated
  7. Configure your network. DHCP is active, so either plug-in your ethernet cable or configure WLAN using this guide. Tip: You should either use your router or configure raspbian to assign the RPI a static IP.
  8. Install the firmware updater and run it: sudo apt-get install -y rpi-update and run it sudo rpi-update
  9. Now reboot your RPI sudo reboot and connect to it using SSH using your shell. On windows, use putty or whatever (out of scope/interest)

ssh pi@<yourip>

From now on i will refer to your ip as rpihost - so everytime you see that, enter your ip.

ssh pi@rpihost

Install the Docker-Engine

As easy as pie

sudo curl -sSL https://get.docker.com | sh

And now let our pi user be able to use docker

sudo usermod -aG docker pi

No login out of your ssh shell and login again, so you can run docker ps without issues

Install docker-compose

See this for reference. Thank you Hypriot!

sudo apt-get update
sudo apt-get -y install python-pip
sudo pip install docker-compose

Special configuration

  1. Only with ZWave GPIO Controllers: Enable our pi user to use the UART0 module: sudo usermod -a -G dialout "pi"
  2. If you have as Raspberry 3 with a GPIO controller ( e.g razberry ) see [[Disable Bluetooth|RPI3.-Raspberry-PI-3---GPIO-Zwave-controller-only:-Disable-Bluetooth]]

Follow up

  1. Now install Home Assistan Docker image
  2. Check the issue queue for current issues