NiceYT-DLP Docker

Configure host permissions

Docker Compose runs the app with your host UID and GID so downloaded files belong to your user.

Copy the example environment file:

cp .env.example .env

Set PUID and PGID in .env to the output of:

id -u
id -g

The defaults are both 1000.

Create the persistent directories as your host user:

mkdir -p downloads config

If these directories were previously created by root, repair them once:

sudo chown -R "$(id -u):$(id -g)" downloads config

Start

docker compose up -d --build

Open http://localhost:8080.

Downloads are saved to ./downloads and settings are persisted in ./config.

Stop

docker compose down

Custom host paths

Edit the volume mappings in compose.yaml:

volumes:
  - /path/to/downloads:/downloads
  - /path/to/config:/config

Keep the app download location set to /downloads inside the container.