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 install
after installing RancherOS to an 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
n
ew partition[Enter]
four (4x) times to accept the defaultsw
rite the table and exitsudo reboot
to reboot and reload the new partition tablesudo mkdir /mnt/docker
to create the directory to be used as the new Docker rootsudo ros config set rancher.docker.extra_args [-g,/mnt/docker]
to configure Docker to use the new rootsudo mkfs.ext4 /dev/mmcblk0p3
to format the disksudo ros config set mounts "[['/dev/mmcblk0p3','/mnt/docker','ext4','']]"
to preserve this mount after rebootssudo mount /dev/mmcblk0p3 /mnt/docker
to mount the Docker rootsudo system-docker restart docker
to restart Docker using the new rootIf this is not a new installation, you’ll have to copy over your existing Docker root (/var/lib/docker
) to the new root (/mnt/docker
).
sudo cp -R /var/lib/docker/* /mnt/docker
to recursively copy all filessudo system-docker restart docker
to restart Docker using the new root