import Navbar from '@/components/Navbar'; import Footer from '@/components/Footer'; import DocsLayout from '@/components/docs/DocsLayout'; export const metadata = { title: 'Install Lidarr — DashCaddy Docs', description: 'Install and configure Lidarr via DashCaddy. Music collection manager for Usenet and BitTorrent', }; export default function lidarrDocsPage() { return (
Category: Media Management Difficulty: Intermediate Docker image: linuxserver/lidarr:latest

What is Lidarr?

Music collection manager for Usenet and BitTorrent

Lidarr ships as a self-contained Docker image that DashCaddy provisions with one click. The platform handles the container lifecycle, DNS, reverse proxy, HTTPS certificate, and persistent storage so you can focus on using Lidarr, not installing it.

Prerequisites

  • A running DashCaddy host with the dashboard accessible.
  • No special host paths required.
  • If you want a stable subdomain: Technitium DNS recommended (otherwise DashCaddy will use direct IP access).

Install via the DashCaddy dashboard

  1. Sign in at https://status.sami (or your host's dashboard URL).
  2. Open Apps → Catalog and select Lidarr from the Media Management category.
  3. Choose your host (or pick Local if you have one host).
  4. Fill in any required fields (notably the media library path and any claim token).
  5. Click Deploy. DashCaddy will:
    1. Pull the linuxserver/lidarr:latest image.
    2. Create persistent volumes for config and data.
    3. Reserve a host port and wire it through Caddy.
    4. Issue a Let's Encrypt certificate for lidarr.<your-domain>.
    5. Wait for the container health check (/api/v1/system/status) to pass.
  6. After ~30–60 seconds the dashboard will turn the row Running and the URL will become clickable.

Install via the REST API

If you script deployments or use the MCP / AI Intent Router, install with:

curl -X POST https://your-dashcaddy-host/api/v1/apps/deploy \\
  -H "Authorization: Bearer $DASHCADDY_API_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "template": "lidarr",
    "host": "local",
    "subdomain": "lidarr",
    "port": "{{PORT}}",
    "environment": {
      "PUID": "",
      "PGID": "",
      "TZ": ""
    },
    "labels": { "managed-by": "dashcaddy" }
  }'

Response returns a deployment ID. Poll GET /api/v1/apps/{id}/status until state === "running".

Install via the AI Intent Router

From any chat surface wired to DashCaddy's MCP server, just say:

"Deploy Lidarr on my home host and expose it at lidarr.sami"

The Intent Router will pick the right template, prompt you for any missing fields, and start the deployment.

Post-install: first-run checklist

  1. Configure download clients
  2. Add indexers
  3. Set up root folders for music

Volumes and persistent data

DashCaddy creates these volume mounts:

  • /opt/lidarr/config:/config
  • /downloads:/downloads
  • /music:/music

All paths are absolute host paths; the left side is the container-side mount. Restarting the container never deletes the data; reinstalling the template preserves it unless you explicitly check Wipe data on the deploy form.

Environment variables

  • PUID
  • PGID
  • TZ

Override any of these from the deploy form's Environment panel, or programmatically in the API environment object.

Updating

DashCaddy's built-in Watchtower integration will pull linuxserver/lidarr:latest every 24 hours and restart your container with zero downtime if the image digest changes. To force an update immediately, click Apps → Lidarr → Update.

Backups

The config volume for Lidarr is included in DashCaddy's default nightly snapshot. To restore on a fresh host, redeploy the same template and DashCaddy will prompt to restore from the most recent snapshot during install.

Troubleshooting

Common issues with Lidarr:

  • Container won't start: check the dashboard's Logs tab. Most startup failures are permission errors on the media/config volume.
  • Slow first scan: expected for large libraries on first run. Subsequent restarts are fast.

For layer-by-layer diagnostics, see the Troubleshooting guide.

Related services

Lidarr is in the Media Management category. Common pairings:


Last reviewed against DashCaddy product version in dashcaddy-api/src/docker/app-templates.js. Template ID: lidarr. If anything here looks wrong, edit the file and the change will appear in the next docs rebuild.

); }