youtube-dl-nas
★ 200MIT LicenseOpen Source — No PaywallSingle Container — single container — minimal hosting footprintDocker · ComposeNo external DB2 active committers (12mo)
About
youtube-dl-nas is a compact, NAS-oriented web application for queuing video, audio, and subtitle downloads. It is designed for home servers and NAS setups where users want a small authenticated...
Community Ratings
No ratings yetNew this week
Read recap →Weekly Recap — Oct 2, 2026 – Oct 9, 2026Oct 9, 2026
Features
- download queue
- authenticated web dashboard
- real-time progress updates
- download history
- file actions
- REST API
- subtitle comparison QA
- mobile sharing
- mounted folder file scanning
- automatic yt-dlp updates
Details
- Last Updated
- Oct 11, 2026
- Created
- Sep 21, 2018
- Install Methods
- dockerdocker-compose
- Requirements
- yt-dlpDenonlptutti
- Authentication
- local
- API
- REST
- Backup & Export
- file-backupapi-export
- Runtime / Stack
- PythonDocker
- Privacy & Independence
- No Cloud RequiredOffline Capable
- Deployment
Deployment: Docker Compose ✓Single Container — minimal hosting footprintsingle container
Run youtube-dl-nas with Docker Compose
Compose file from the youtube-dl-nas project repository.
1 service
no resource limits declared
needs persistent storage (2 volumes)
compose.yaml · @ 659233c · scanned Sep 27, 2026
services:
youtube-dl-nas:
image: modenaf360/youtube-dl-nas:latest
container_name: youtube-dl-nas
restart: unless-stopped
ports:
- "${WEB_PORT:-8080}:8080"
environment:
MY_ID: "${MY_ID:-}"
MY_ID_FILE: "${MY_ID_FILE:-}"
MY_PW: "${MY_PW:-}"
MY_PW_FILE: "${MY_PW_FILE:-}"
TZ: "${TZ:-UTC}"
DOWNLOAD_DIR: "/downfolder"
STATE_DIR: "/usr/src/app/metadata"
PUID: "${PUID:-0}"
PGID: "${PGID:-0}"
UMASK: "${UMASK:-022}"
YTDLP_AUTO_UPDATE: "${YTDLP_AUTO_UPDATE:-true}"
YTDLP_UPDATE_INTERVAL: "${YTDLP_UPDATE_INTERVAL:-3600}"
NLPTUTTI_AUTO_UPDATE: "${NLPTUTTI_AUTO_UPDATE:-true}"
NLPTUTTI_UPDATE_TIMEOUT: "${NLPTUTTI_UPDATE_TIMEOUT:-180}"
YTDLP_COOKIES_FILE: "${YTDLP_COOKIES_FILE:-}"
YTDLP_EXTRA_ARGS: "${YTDLP_EXTRA_ARGS:-}"
YDLNAS_ALLOW_PRIVATE_SOURCES: "${YDLNAS_ALLOW_PRIVATE_SOURCES:-false}"
YDLNAS_STORAGE_WARNING_GB: "${YDLNAS_STORAGE_WARNING_GB:-10}"
YDLNAS_STORAGE_CRITICAL_GB: "${YDLNAS_STORAGE_CRITICAL_GB:-2}"
YDLNAS_MCP_BATCH_LIMIT: "${YDLNAS_MCP_BATCH_LIMIT:-25}"
YDLNAS_API_TOKEN: "${YDLNAS_API_TOKEN:-}"
YDLNAS_API_TOKEN_FILE: "${YDLNAS_API_TOKEN_FILE:-}"
COOKIE_SECURE: "${COOKIE_SECURE:-false}"
PROXY: "${PROXY:-}"
volumes:
- "${DOWNLOAD_DIR:-./downloads}:/downfolder"
- "${CONFIG_DIR:-./config}:/usr/src/app/metadata"
This file may be out of date. Check the youtube-dl-nas documentation for current setup steps.
Tags
Track your self-hosted stack
Bookmark software to try, rate tools you've used, and keep your collection in one place.
Metadata extracted from README on Jul 17, 2026
Related Software
Immich
116.3k
High performance self-hosted photo and video management solution.
Photo GalleriesCopyleft LicenseMedia Management+1
6 Containers
Navidrome Music Server
24.2k
Navidrome is an open source web-based music collection server and streamer for browsing and listening to a personal music library from a browser or mobile device.
Audio StreamingMedia ManagementSelf Hosting Solutions+1
Single Container
Cap
23.3k
Cap is an open source screen recording platform for creating, editing, and sharing polished videos with team collaboration features.
Video EditingCopyleft LicenseMedia Management+1
5 ContainersTelemetry: Opt-Out
Jellyfin
58.1k
Jellyfin is a free software media server for managing and streaming personal media to client devices.
Multimedia StreamingCopyleft LicenseMedia Management+3
Cloudreve
28.8k
Cloudreve is a self-hosted file management system with multi-cloud storage support.
File SynchronizationCopyleft LicenseWeb File Managers+4
3 Containers
Audiobookshelf
14.6k
Audiobookshelf is a self-hosted audiobook and podcast server.
Audio StreamingE-Book ManagementCopyleft License+2
Seerr
12.9k
Seerr is a free and open source application for managing media library requests and integrating with services like Jellyfin, Plex, Emby, Sonarr, and Radarr.
Media ManagementPermissive LicenseMedia Servers+2
Single Container
photocraft
61.3k
PhotoCraft is an open-source, native image editor that reimplements Adobe Photoshop in pure Rust, with layered editing, masks, vectors, filters, and real PSD support.
Media ManagementFully FOSS
Fully FOSS
Stash
13.1k
Stash is a self-hosted web app for organizing, browsing, and tagging video and image collections, with metadata scraping and statistics.
Multimedia StreamingCopyleft LicenseMedia Management+3
Single Container
qBittorrent
40.8k
qBittorrent is a BitTorrent client built in C++/Qt and powered by libtorrent.
P2P File SharingCopyleft LicenseMedia Management+2
MeTube
15.0k
A web GUI for youtube-dl/yt-dlp that lets users download videos from YouTube and other supported sites, with playlist support.
Media ManagementCopyleft LicenseMedia Servers+2
Kodi
21.3k
Kodi is a free and open source media player and entertainment hub for digital media.
Multimedia StreamingCopyleft LicenseMedia Management+1