mirror of https://github.com/nickyeoman/docker-compose-cookbooks.git synced 2026-09-03 18:36:22 +00:00

Files

T

codeandClaude Fable 5 8ab413804a normalize all stacks to conventions

- VOL_PATH always defaults to /data; vscode/opencode VOL_PROJECTS nests it
- TZ defaults to America/Vancouver (was UTC in etherpad, ntfy, redis)
- compose section order fixed (volumes before environment, command after networks)
- all default secrets are the literal ChangeThisPassword (grep-friendly,
  users must change them); removed a real key from ollama sample.env
- sample.env synced with compose: missing vars added with defaults, dead vars removed
- invoiceninja_dev/openarchiver_dev: app services had no environment block,
  wired all sample.env vars through so the stacks actually work
- opencode: sample.env OLLAMA_HOST renamed to OLLAMA_HOST_URL to match compose
- TZ values unquoted consistently

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-16 06:24:54 +00:00

compose.yaml

fix minor convention issues across 10 stacks

2026-07-16 04:53:51 +00:00

README.md

added spotdl

2026-07-02 21:41:48 -07:00

sample.env

normalize all stacks to conventions

2026-07-16 06:24:54 +00:00

README.md

spotDL

Overview

spotDL is a command-line music downloader that finds Spotify tracks on YouTube and downloads them with album art, lyrics, and metadata. This stack runs the optional web UI, providing a browser interface where you can paste Spotify links to download tracks, albums, or playlists.

Project Details

Project Repository: https://github.com/spotDL/spotify-downloader
Container Image: spotdl/spotify-downloader
Web UI Port: 8800

Getting Started

Open http://localhost:8800 in your browser:

Find a Spotify track, album, or playlist URL
Paste it into the spotDL web UI
Click download — spotDL finds the song on YouTube and saves it as an MP3 with full metadata

Downloaded files appear in the /music volume.

Environment Variable Notes

Variable	Description
`SPOTDL_IMAGE`	Container image (default: `spotdl/spotify-downloader:latest`)
`SPOTDL_RESTART`	Restart policy (default: `unless-stopped`)
`SPOTDL_PORT`	Published port for the web UI (default: `8800`)
`VOL_PATH`	Base path for persistent data volumes (default: `/data`)

Volume Notes

Volume	Purpose
`${VOL_PATH:-/data}/spotdl/music`	Downloaded music files

Network Notes

Requires an external proxy network. Create it once with:

docker network create proxy

Docker Run

docker run -d \
  --name=spotdl \
  -p 8800:8800 \
  -v ${VOL_PATH:-/data}/spotdl/music:/music \
  --network proxy \
  --restart unless-stopped \
  spotdl/spotify-downloader:latest \
  web

Dockhand Stack, Deploy from Git

Cookbooks Repository
stackname: spotdl_dev
Compose file path: spotdl_dev/compose.yaml
Additional env file (optional): spotdl_dev/sample.env

Load spotdl_dev/sample.env into the Environment variables in Dockhand, then create the Stack.