diff --git a/README.md b/README.md
index d77165c..0e987cc 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,40 @@
-# The openSUSE Tumbleweed OCI Container Registry (Distribution) Container image
+# The SLE BCI Distribution Image
 
-OCI Container Registry (Distribution) container based on the openSUSE Tumbleweed Base Container Image.
+This container image allows to run a local OCI registry. Before you start the container,
+you need to create a `config.yml` with the following content:
+
+```yaml
+---
+version: 0.1
+log:
+  level: info
+storage:
+  filesystem:
+    rootdirectory: /var/lib/docker-registry
+http:
+  addr: 0.0.0.0:5000
+```
+
+You can also create an empty directory for storing the images outside the container:
+
+```bash
+mkdir -p /var/lib/docker-registry
+```
+
+Then you can start the container with the following command:
+
+```bash
+podman run -d --restart=always -p 5000:5000 -v /path/to/config.yml:/etc/docker/registry/config.yml \
+  -v /var/lib/docker-registry:/var/lib/docker-registry --name registry registry.opensuse.org/opensuse/registry:%%registry_version%%-%RELEASE%
+```
+
+The registry is available at `http://localhost:5000`. To keep the registry running after a reboot, create a systemd service as follows:
+
+```bash
+sudo podman generate systemd registry > /etc/systemd/system/registry.service
+sudo systemctl enable --now registry
+```
+
+
+## License
+ SPDX-License-Identifier: Apache-2.0
\ No newline at end of file
diff --git a/distribution-image.changes b/distribution-image.changes
index b6c97fa..676222c 100644
--- a/distribution-image.changes
+++ b/distribution-image.changes
@@ -1,3 +1,8 @@
+-------------------------------------------------------------------
+Fri Mar 22 17:20:58 UTC 2024 - Dirk Mueller <dmueller@suse.com>
+
+- add readme and logo urls
+
 -------------------------------------------------------------------
 Wed Jan 17 14:29:14 UTC 2024 - Dan Čermák <dcermak@suse.com>