Skip to content

izer-xyz/imagine

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

imagine

Custom openwrt image to run dockerd on RPi 4.

Goals

  • Minimal reproductible host OS
  • Easy upgrade

How

  • OpenWRT base
    • Well maintained and tested
    • Automated build (ImageBuilder + Action)
    • Rich list of packages
    • Secure by default

Components

The Image

Look around this repo.

Limited base packages plus:

  • block-mount - auto mount extra partition
  • dockerd - run containers
  • collectd - some stats

Skip packages related to:

  • audio
  • wifi

The File System

  • SquashFS - Compressed read-only file system
  • Default image size ~100Mb
  • Layout

The Supervisor

  • dockerd
  • Docker Swarm
  • Portainer

The Services

See beast

Usage

Install / Initial Setup

Hardware

  • RPi 4b - more the RAM the better
  • SD Card (maybe optional with usb boot)
  • External Drive

Steps

  1. Download the latest image (rpi-4-squashfs-factory.img.gz) from Release
  2. Write image to the SD Card (balenaEtcher)
  3. ...

Upgrade

  1. ssh to the box
  2. # sysupgrade https://github.com/izer-xyz/imagine/releases/latest/download/rpi-4-squashfs-sysupgrade.img.gz