diff --git a/sonarr/README.md b/sonarr/README.md
new file mode 100644
index 0000000..6116369
--- /dev/null
+++ b/sonarr/README.md
@@ -0,0 +1,7 @@
+# Sonarr
+
+Official site: https://sonarr.tv/
+Proxy port: 8989
+composer example: https://hotio.dev/containers/sonarr/#__tabbed_1_2
+
+Sonarr is a PVR (Personal Video Recorder) designed to automatically find, download, and manage your TV series collection. It monitors your favorite shows for new episodes and, once they are posted to your indexers, grabs them and sends them to your download client. After the download completes, Sonarr automatically renames the episode files to a clean and consistent format, sorts them into the appropriate series and season folders within your media library, and updates your media server (like Plex, Jellyfin, or Emby). It's also capable of searching for missing past episodes and automatically upgrading existing files to a higher quality when they become available, ensuring your collection is always complete and up-to-date.
diff --git a/sonarr/docker-compose.yml b/sonarr/docker-compose.yml
new file mode 100644
index 0000000..262f470
--- /dev/null
+++ b/sonarr/docker-compose.yml
@@ -0,0 +1,13 @@
+services:
+  sonarr:
+    image: ${SONARR_IMAGE}
+    ports:
+      - "8989:8989"
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - UMASK=002
+      - TZ=${TZ}
+    volumes:
+      - ${VOL_PATH}/sonarr/config:/config
+      - ${VOL_PATH}/sonarr/data:/data
diff --git a/sonarr/sample.env b/sonarr/sample.env
new file mode 100644
index 0000000..deab381
--- /dev/null
+++ b/sonarr/sample.env
@@ -0,0 +1,4 @@
+# Sonarr
+VOL_PATH=./data/sonarr/config
+SONARR_IMAGE=ghcr.io/hotio/sonarr:release
+TZ="America/Vancouver"