From e5dfe2eb5e5355ee48d01a58dd5e224aefebcf63 Mon Sep 17 00:00:00 2001
From: Beda Schmid <beda@tukutoi.com>
Date: Tue, 4 Aug 2026 23:08:38 +0000
Subject: [PATCH] Reset history to current sanitized state

---
 .gitignore         | 10 ++++++++++
 README.md          | 24 ++++++++++++++++++++++++
 docker-compose.yml | 22 ++++++++++++++++++++++
 3 files changed, 56 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 README.md
 create mode 100644 docker-compose.yml

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..a36ad05
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,10 @@
+# BEGIN reset-history environment exclusions
+.env
+.env.*
+*.env
+*.env.*
+!.env.example
+!.env.*.example
+!*.env.example
+!*.env.*.example
+# END reset-history environment exclusions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5e66ab1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# Sonobarr
+
+Self-hosted music discovery and recommendation service that integrates with Lidarr.
+
+## Deployment layout
+
+- **Compose:** `/srv/docker/sonobarr/docker-compose.yml`
+- **Static configuration/source:** no additional static configuration or build source
+- **Non-secret environment:** the Lidarr address, quality profile ID, similar-artist batch size, and Gunicorn
+control-socket setting are declared inline in Compose; there is no project-local `.env`
+- **Secrets:** `/srv/docker/secrets/sonobarr/.env`
+- **NVMe application state:** `/srv/appdata/sonobarr/config`
+- **Bulk HDD data:** none
+- **Other mounts:** `/etc/localtime` is mounted read-only
+
+Secrets are never committed to this repository. The central secret environment
+is supplied to the Sonobarr service.
+
+## Dependencies and recovery
+
+- **Networks/dependencies:** Sonobarr uses the external `npm_proxy` network at `192.168.97.23` and connects to
+Lidarr at `http://192.168.97.13:8686`
+- **Back up:** `/srv/appdata/sonobarr/config` and the separately protected Sonobarr secret environment
+- **Re-creatable:** the Sonobarr container itself; no persistent cache or bulk-data path is declared
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000..98cb413
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,22 @@
+services:
+  sonobarr:
+    image: ghcr.io/dodelidoo-labs/sonobarr:latest
+    container_name: sonobarr
+    env_file:
+      - /srv/docker/secrets/sonobarr/.env
+    environment:
+      GUNICORN_CMD_ARGS: --no-control-socket
+      LIDARR_ADDRESS: http://192.168.97.13:8686
+      QUALITY_PROFILE_ID: 2
+      SIMILAR_ARTIST_BATCH_SIZE: 10
+    volumes:
+      - /srv/appdata/sonobarr/config:/sonobarr/config
+      - /etc/localtime:/etc/localtime:ro
+    restart: unless-stopped
+    networks:
+      npm_proxy:
+        ipv4_address: 192.168.97.23 # change to an available IP on your proxy network
+
+networks:
+  npm_proxy:
+    external: true