spotiarr-docker

Configure Docker deployment for SpotiArr with persistent SQLite data and Redis queues.

41|6|Updated Nov 27, 2025
One-click install
npx skills add https://github.com/mralexsaavedra/spotiarr --skill spotiarr-docker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spotiarr-docker
Source: https://github.com/mralexsaavedra/spotiarr/tree/main/skills/spotiarr-docker
Command: npx skills add https://github.com/mralexsaavedra/spotiarr --skill spotiarr-docker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the challenge of deploying SpotiArr reliably with Docker while ensuring persistent storage for the SQLite database, downloads, and Redis queues.

Core Features & Use Cases

  • Containerized deployment blueprint: Defines the spotiarr app container plus required supporting services like redis, with an optional traefik reverse proxy for production routing.
  • Correct persistent volumes and mount points: Ensures /spotiarr/config is backed by a Docker volume/host bind mount so the SQLite database and app data persist across restarts.
  • Safe operational guardrails: Prevents committing ./config/ and docker-compose.override.yml, clarifies how to reach the service directly, and documents the app startup dependency on Redis health.

Quick Start

Ask me for a working docker-compose setup for SpotiArr that persists ./config and downloads to an absolute DOWNLOADS_DIR, waits for Redis health before starting, and uses the required Spotify environment variables for local access.

Frequently Asked Questions about spotiarr-docker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a docker-compose deployment for SpotiArr with persistent storage?

To configure a docker-compose deployment for SpotiArr with persistent storage, you bind a Docker volume to the `/spotiarr/config` directory. This ensures your SQLite database and app data persist across container restarts.

How does Redis health-based service startup ordering work with SpotiArr containers?

Redis health-based service startup ordering ensures the Spotiarr container waits for a healthy Redis status before launching. This guarantees the Redis-backed job queue is ready to accept tasks for reliable media automation.

Do I need absolute paths for volume mounts when self-hosting Spotify downloaders?

Yes, you must use an absolute path for the mandatory `DOWNLOADS_DIR` environment variable when self-hosting Spotify downloaders. This ensures Docker correctly maps the host directory for managing downloaded media files.

Can I use Traefik as a reverse proxy for a self-hosted SpotiArr Docker setup?

Yes, you can use Traefik as a reverse proxy for a self-hosted SpotiArr Docker setup. The deployment blueprint includes optional Traefik configuration for production routing and external connectivity.

What environment variables are required for Spotiarr local access and OAuth?

Spotiarr local access and OAuth require mandatory Spotify client credential environment variables. You must validate these settings to ensure the application can authenticate and connect to Spotify's API.

Why should I gitignore the config directory and docker-compose override files?

You should gitignore the `./config/` directory and `docker-compose.override.yml` to implement safe operational guardrails. This prevents committing sensitive local configuration data and OAuth credentials to version control.