diff --git a/.gitignore b/.gitignore
index 68ab33d..2e04c00 100644
--- a/.gitignore
+++ b/.gitignore
@@ -411,4 +411,6 @@ data/
 !.env.*.example
 !*.env.example
 !*.env.*.example
+*.swp
+.DS_Store
 # END reset-history environment exclusions
diff --git a/README.md b/README.md
index 20b6724..23e1e09 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,26 @@
-# navidrome
+# Navidrome
 
-Welcome to Navidrome! Learn More Download Your Personal Streaming Service Navidrome allows you to enjoy your music collection from anywhere, by making it available through a modern Web UI and through a wide range of third-party compatible mobile apps, for both iOS and Android devices.
\ No newline at end of file
+Self-hosted music streaming server providing a web interface and Subsonic-compatible access to the shared music library.
+
+## Deployment layout
+
+- **Compose:** `/srv/docker/navidrome/docker-compose.yml`
+- **Static configuration/source:** no additional static configuration or build source
+- **Non-secret environment:** scan scheduling, logging, session timeout, base URL, transcoding configuration, plugin behavior, and metadata
+agents are declared inline in Compose; there is no project-local `.env`
+- **Secrets:** `/srv/docker/secrets/navidrome/.env`
+- **NVMe application state:** `/srv/appdata/navidrome/data`
+- **Bulk HDD data:** none
+- **Other mounts:** shared `/data/Data1/music` library at `/music`, read-only
+
+Secrets are never committed to this repository. The central secret environment
+is supplied to the Navidrome service.
+
+## Dependencies and recovery
+
+- **Networks/dependencies:** external `npm_proxy` network at `192.168.97.14`; configured metadata and plugin integrations use credentials
+supplied through the protected central environment
+- **Back up:** `/srv/appdata/navidrome/data`, the separately managed `/data/Data1/music` library, and the separately protected Navidrome
+secret environment
+- **Re-creatable:** the Navidrome container; music indexes and artwork caches can be rebuilt but share the application-data tree with
+persistent database and user state
diff --git a/docker-compose.yml b/docker-compose.yml
index 9e8bb1a..7daa4e6 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -20,7 +20,7 @@ services:
       ND_AGENTS: "audiomuseai,lastfm,spotify,deezer"
       ND_DEVARTISTINFOTIMETOLIVE: 1s
     volumes:
-      - "./data:/data"
+      - "/srv/appdata/navidrome/data:/data"
       - "/data/Data1/music:/music:ro"
     networks:
       npm_proxy: