diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000..97d3cbb
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,31 @@
+version: "3.8"
+
+services:
+  immich-frame:
+    build: .
+    container_name: immich-frame
+    restart: unless-stopped
+    ports:
+      - "3000:3000"
+    environment:
+      # REQUIRED: Your Immich server URL (no trailing slash)
+      - IMMICH_URL=http://your-immich-server:2283
+      # REQUIRED: Your Immich API key
+      - IMMICH_API_KEY=your-api-key-here
+
+      # OPTIONAL: Slideshow settings
+      - SLIDESHOW_INTERVAL=30        # Seconds between photos
+      - TRANSITION_DURATION=2         # Crossfade duration in seconds
+      - IMAGE_FIT=contain             # 'contain' or 'cover'
+      - SHUFFLE=true                  # Randomise photo order
+      - BACKGROUND_BLUR=true          # Blurred background behind photos
+
+      # OPTIONAL: Overlay settings
+      - SHOW_CLOCK=true               # Show time overlay
+      - SHOW_DATE=true                # Show date overlay
+      - SHOW_EXIF=true                # Show photo location/camera info
+      - SHOW_PROGRESS=true            # Show progress bar
+
+      # OPTIONAL: Auto-start with specific album or favorites
+      # - ALBUM_ID=                   # Auto-start with this album UUID
+      # - SHOW_FAVORITES_ONLY=false   # Auto-start showing only favorites