From 84a54391b779da92648d2cc24d7f1e706c4529a9 Mon Sep 17 00:00:00 2001 From: Laborratte5 Date: Thu, 26 Mar 2026 13:56:50 +0100 Subject: [PATCH] Add README --- README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..7aa08d6 --- /dev/null +++ b/README.md @@ -0,0 +1,21 @@ +This project aims to simplify the provision of [Raspbian](https://www.raspberrypi.com/software/operating-systems/) +on the raspberry pi. + +# How exactly does this project help? + +This command liune tool does a view things: +1. It decompresses the `.xz` compressed image file +2. It flashes the image onto an sd-card +3. It resizes the main filesystem to the whole sd card size +4. It sets the cloud-init configuration for: + 1. Network provisioning (setting a static IP-Address so one does not have to look into the router to get the assigned IP-Address) + 2. User provisioning (creates a user and sets the allowed ssh key so it is easy to login in headless mode) + +# Why not Raspberry Pi Imager + +The [Raspberry Pi Imager](https://www.raspberrypi.com/documentation/computers/getting-started.html#raspberry-pi-imager) +also allows you to provision the flashed Raspbian image. +However currently the Pi-Imager does not directly work under wayland and needs some environment variables to be set. +Moreover, it is not possible to run the Pi Imager without root permissions, the problem with this is that the Pi Imager +still has a GUI and running GUI applications a root does not _feel_ right (at least in my opinion). +