Youtarr

Overview

Youtarr is a self-hosted YouTube downloader that automatically downloads videos from your favorite channels or specific URLs. With optional Plex integration, it can refresh your media library for a seamless, ad-free viewing experience. By default the container runs as root. To run as a non-root user (e.g. nobody:users so Plex/Jellyfin can manage the downloaded files), see the Unraid-specific instructions at https://github.com/DialmasterOrg/Youtarr/blob/main/docs/platforms/Unraid.md

Requirements

Requires a separate MariaDB database instance.

Runtime arguments

Web UI: http://[IP]:[PORT:3011]/
Network: bridge
Privileged: false

Template configuration

Web UI PortPorttcp

Container Port: 3011

Target: 3011
Default: 3011
Value: 3011

YouTube Output DirectoryPath

Path to store downloaded YouTube videos

Target: /usr/src/app/data

YouTube Output Directory HostVariable

Host path to your downloaded YouTube videos. Should match the host side of 'YouTube Output Directory' above. Used only to display the path inside the Youtarr web UI.

Target: YOUTUBE_OUTPUT_DIR

Database - HostVariable

Hostname or IP of your MariaDB server. On Unraid, use your server's LAN IP (e.g. 192.168.1.100). Do NOT use 'localhost' or '127.0.0.1' - those resolve to this container, not your Unraid host.

Target: DB_HOST

Database - PortVariable

Port of your MariaDB server. Standard MariaDB is 3306.

Target: DB_PORT
Default: 3306
Value: 3306

Database - NameVariable

Name of the database Youtarr should use. Must already exist on your MariaDB server.

Target: DB_NAME
Default: youtarr
Value: youtarr

Database - UserVariable

MariaDB username with read/write access to the database above.

Target: DB_USER

Database - PasswordVariable

Password for the MariaDB user above.

Target: DB_PASSWORD

Auth - EnabledVariable

Enable the built-in login for Youtarr's web UI. Leave 'true' unless Youtarr is only reachable over LAN/VPN or is behind an authenticating reverse proxy - setting 'false' exposes the full UI with no password.

Target: AUTH_ENABLED
Default: true|false

Auth - UsernameVariable

Strongly recommended on Unraid: set this and Auth - Password together to seed initial login credentials. Without them, Youtarr's first-run setup wizard only accepts connections from 'localhost' on the Unraid host, which is awkward for headless installs. Must be 3-32 characters; if either this or Auth - Password fails validation, both are ignored.

Target: AUTH_PRESET_USERNAME

Auth - PasswordVariable

Initial admin password (8-64 characters). Must be set together with Auth - Username or both are ignored. You can change this later from within the Youtarr UI.

Target: AUTH_PRESET_PASSWORD

Config StoragePath

Path to store configuration files

Target: /app/config
Default: /mnt/user/appdata/youtarr/config
Value: /mnt/user/appdata/youtarr/config

Image StoragePath

Path to store images

Target: /app/server/images
Default: /mnt/user/appdata/youtarr/images
Value: /mnt/user/appdata/youtarr/images

Job StoragePath

Path to store job files

Target: /app/jobs
Default: /mnt/user/appdata/youtarr/jobs
Value: /mnt/user/appdata/youtarr/jobs

Log LevelVariable

Logging verbosity. Options: info (default), warn, debug.

Target: LOG_LEVEL
Default: info|warn|debug

In Docker Container FlagVariable

Not recommended to change.

Target: IN_DOCKER_CONTAINER
Default: 1
Value: 1

Links

Template Support Docker Hub Project

Details

Repository

dialmaster/youtarr:latest

Registry

https://hub.docker.com/r/dialmaster/youtarr

Last Updated2026-05-07

First Seen2025-11-08

Run Youtarr on Unraid.

Youtarr is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS