From 2fad395bb59d19cd719dbd6380112ddba3f689dc Mon Sep 17 00:00:00 2001
From: miampf <miampf@proton.me>
Date: Tue, 14 Jan 2025 15:46:19 +0100
Subject: [PATCH] docs(image): Add section for adding new packages (#3575)

---
 image/README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/image/README.md b/image/README.md
index 4316f6cfc..c0d8c1975 100644
--- a/image/README.md
+++ b/image/README.md
@@ -60,3 +60,15 @@ After building a Kernel rpm, we upload it to our CDN and use it in our image bui
   - `bazel build //image/system:IMAGE_NAME_HERE` (replace with an actual image name)
 - Let CI build new images and run e2e tests
 - Upgrade kernel spec under [edgelesssys/constellation-kernel](https://github.com/edgelesssys/constellation-kernel) to use new releasever
+
+## Adding new packages to the image
+
+- Find the package (i.e. it's _package name_) on [Koji](https://koji.fedoraproject.org/koji/)
+- Add the package to the corresponding section in `./base/mkosi.conf`
+  - If the package is required to be present in the initrd, add it to `./initrd/mkosi.conf`
+- Add the package to `./mirror/packages.txt`
+- Update the package mirror:
+  ```sh
+  bazel run //image/mirror:update_packages
+  ```
+- Build new images (e.g. via CI) and run e2e tests