Skip to content

Latest commit

 

History

History
89 lines (61 loc) · 3.72 KB

README.rst

File metadata and controls

89 lines (61 loc) · 3.72 KB
Raw

Ubuntu 64bit with Docker for Raspberry Pi

An out of the box Raspberry Pi Ubuntu distro with a 64bit chroot with docker.

Donate

UbuntuDockerPi is 100% free and open source and maintained by Guy Sheffer. If its helping your life, your organisation or makes you happy, please consider making a donation. It means I can code more and worry less about my balance. Any amount counts. Also many thanks to people contributing code.

paypal

Where to get it?

You can use the pi-imager commuity raspberrypi imager here, unofficial section.

Or download directly form the official mirror here

Nightly builds are available on pi-imager above or here (currently built on demand)

How to use it?

  1. Unzip the image and install it to an SD card like any other Raspberry Pi image
  2. Configure your WiFi by editing ubuntudocker-wpa-supplicant.txt at the root of the flashed card when using it like a flash drive
  3. Boot the Pi from the SD card
  4. Hostname is ubuntudocker (not raspberrypi as usual)
  5. Username is ubuntu initial password ubuntu. You will be prompted to change it after first login.

Requirements

  • Raspberry Pi 3B+, 4B
  • 2A power supply

Features

  • Ubuntu 64bit (aarch64) with docker
  • Wifi file that lest you set up the Pi wifi out of the box, unlike official build that you need to plug and configfure and ethernet connection to download the wifi packages.
  • Tools to configure the network via text files /boot

Developing

Build UbuntuDockerPi

UbuntuDockerPi can be built using docker running either on an intel or RaspberryPi (supported ones listed). Build requires about 4.5 GB of free space available. You can build it assuming you already have docker and docker-compose installed issuing the following commands:

git clone https://github.com/guysoft/UbuntuDockerPi.git
cd UbuntuDockerPi/src/image
wget -c --trust-server-names 'https://cdimage.ubuntu.com/releases/20.04.4/release/ubuntu-20.04.4-preinstalled-server-arm64+raspi.img.xz'
cd ..
sudo docker-compose up -d
sudo docker exec -it ubuntudockerpi-build build

Requirements

  1. You need to build this distro with a Raspberrypi with the 64bit kernel mode enabled, so it can run both armf and aarch64.
  2. CustomPiOS using the Docker build method
  3. root privileges for chroot
  4. Bash

Building UbuntuDocker Variants

Rasbian64 supports building variants, which are builds with changes from the main release build. An example and other variants are available in the folder src/variants/example.

To build a variant use:

sudo bash -x ./build_dist [Variant]

Usage

  1. If needed, override existing config settings by creating a new file src/config.local. You can override all settings found in src/config. If you need to override the path to the Raspbian image to use for building Raspbian64, override the path to be used in ZIP_IMG. By default, the most recent file matching ubuntu-*.xz found in src/image will be used.
  2. Run src/build_dist as root.
  3. The final image will be created in src/workspace

Code contribution would be appreciated!