As of v0.5.0, RancherOS releases include a Raspberry Pi image that can be found on our releases page. The official Raspberry Pi documentation contains instructions on how to install operating system images.
When installing, there is no ability to pass in a cloud-config. You will need to boot up, change the configuration and then reboot to apply those changes.
Currently, only Raspberry Pi 3 is tested and known to work.
Note: It is not necessary to run
ros installafter installing RancherOS to an SD card.
Using the entire SD Card
RancherOS does not currently expand the root partition to fill the remainder of the SD card automatically. Instead, the following workaround can be used to store Docker containers on a larger partition that fills the remainder.
sudo fdisk /dev/mmcblk0
- Create a
[Enter]four (4x) times to accept the defaults
write the table and exit
sudo rebootto reboot and reload the new partition table
sudo mkdir /mnt/dockerto create the directory to be used as the new Docker root
sudo ros config set rancher.docker.extra_args [-g,/mnt/docker]to configure Docker to use the new root
sudo mkfs.ext4 /dev/mmcblk0p3to format the disk
sudo ros config set mounts "[['/dev/mmcblk0p3','/mnt/docker','ext4','']]"to preserve this mount after reboots
sudo mount /dev/mmcblk0p3 /mnt/dockerto mount the Docker root
sudo system-docker restart dockerto restart Docker using the new root If this is not a new installation, you’ll have to copy over your existing Docker root (
/var/lib/docker) to the new root (
sudo cp -R /var/lib/docker/* /mnt/dockerto recursively copy all files
sudo system-docker restart dockerto restart Docker using the new root
Available as of v1.5.2
Here are steps about how to enable Wi-Fi on a Raspberry Pi:
modprobe brcmfmac wpa_passphrase <ssid> <psk> > /etc/wpa_supplicant.conf wpa_supplicant -iwlan0 -B -c /etc/wpa_supplicant.conf # wait a few seconds, then dhcpcd -MA4 wlan0
You can also use cloud-config to enable Wi-Fi:
#cloud-config rancher: network: interfaces: wlan0: wifi_network: network1 wifi_networks: network1: ssid: "Your wifi ssid" psk: "Your wifi password" scan_ssid: 1
Raspberry Pi will automatically drop Wi-Fi connection after a while, this is due to power management. To fix this problem, you can try this:
iwconfig wlan0 power off