dietpi

DietPi

Easily configure and run services optimized for Single-Board Computers.

Introduction

This package core/dietpi enables a Skiff Core image based on DietPi.

It is currently based on the Ubuntu skiff core configuration.

This example is for the Raspberry Pi 4.

The SKIFF_CONFIG comma-separated environment variable selects which configuration layers should be merged together to configure the build.

$ make                             # lists all available layers
$ export SKIFF_CONFIG=pi/4,core/dietpi
$ make configure                   # configure the system
$ make compile                     # build the system

After you run make configure Skiff will remember what you selected in SKIFF_CONFIG. The compile command instructs Skiff to build the system.

You can add your SSH public key to the target image by adding it to overrides/root_overlay/etc/skiff/authorized_keys/my-key.pub, or by adding it to your own custom configuration package.

Once the build is complete, it's time to flash the system to a SD card. You will need to switch to sudo bash for this on most systems.

$ sudo bash             # switch to root
$ blkid                 # look for your SD card's device file
$ export PI_SD=/dev/sdz # make sure this is right!
$ make cmd/pi/common/format  # tell skiff to format the device
$ make cmd/pi/common/install # tell skiff to install the os

The device needs to be formatted only one time, after which, the install command can be used to update the SkiffOS images without clearing the persistent state. The persist partition is not touched in this step, so anything you save there, including Docker state and system configuration, will not be modified.

Connecting to the System

If you need to add your SSH key after the system is configured, mount the "persist" partition and save your id_rsa.pub at skiff/keys/mykey.pub.

Connect to the "dietpi" or "core" user to get started:

$ ssh dietpi@my-ip-address
$ apt update

# Run the dietpi launcher
$ /boot/dietpi/dietpi-launcher

You can ssh to root to access the SkiffOS "shim" system.

Edit /mnt/persist/skiff/core/config.yaml to modify the mapping of users to containers, create more containers, or modify the bind-mounts to storage.