fetchly

fetchly

Docker app from GillBates' Repository

Save video and audio from YouTube, TikTok, Instagram and Facebook in your own library.

Overview
Save video and audio from YouTube, TikTok, Instagram and Facebook in your own library. Paste a link, preview the media, choose a format and follow each download live. Trim audio on an interactive waveform, or use the optional Lalal.ai integration to separate vocals and instruments. Downloads and settings stay in your persistent data folder. First launch has no admin account. Create your username and password in Settings > Security immediately; this template makes the Web UI reachable from your LAN. Keep the secret key and data folder when updating.

fetchly

Self-hosted media downloader for YouTube, TikTok, Instagram & Facebook.
Paste a link, preview it, pick a format — with a live job dashboard, waveform audio trimming, BPM analysis, and Lalal.ai stem separation.

GitHub Release Docker Pulls Docker Image Size
License Platform


fetchly dashboard: link input, video preview, format picker, and recent downloads
Dashboard — paste a link, preview the media, pick a format, and track every job live.

More screenshots

fetchly login screen
Authenticated login with invisible, server-verified anti-bot protection.

fetchly settings: Lalal.ai integration and per-platform cookie tiles
Integrations — connect Lalal.ai for stem separation and paste browser cookies for sign-in-only downloads.

fetchly settings: host resources, component versions, update check, and changelog
System — host resources, component versions, one-click update checks, and the in-app changelog.


Download, shape, share

fetchly turns yt-dlp into a self-hosted media workspace. Pick formats in a web UI, follow every job live, trim audio visually, find its tempo, create stems, and share finished downloads without handing your media to another service.

Features

Feature What you get
Download everywhere Save video or audio from YouTube, TikTok, Instagram, and Facebook in one place.
Stay in control Follow every job from a live dashboard, from queued through downloading and analysis to finished, cancelled, or failed.
Choose your quality Pick the quality you want, then decide what the highest tier produces: H.264 for files that play everywhere, AV1 for the smallest files, or the untouched source for the best resolution.
Brand every video Burn the fetchly logo — or your own uploaded SVG or PNG — and your hostname, once set, into the corner of every downloaded video, or switch it off.
Trim with precision Cut audio visually with an interactive waveform before you download or process it further.
Find the tempo Analyze BPM and beat confidence, use the result to guide audio trimming, and write the detected tempo to the downloaded MP3's TBPM ID3 tag.
Create clean stems Connect Lalal.ai to separate vocals and instrumentals when you need production-ready tracks. Tracks over 10 minutes are refused up front, and Lalal.ai errors are reported in plain words.
Share what you made Send friends and family a share link to a finished download — no account needed on their side, with an optional limit on how many times it can be used.
Keep it private Run everything yourself with persistent storage, authentication, CSRF protection, anti-bot checks, and built-in rate limiting.
Sign-in-only videos, handled Pasting a private or login-required link without cookies shows a warning right away. Import cookies by pasting a cURL, fetch, or PowerShell request, request headers, or JSON; cookies for other domains are rejected.
Gentle on small hosts Memory backpressure follows the container's cgroup limit, so queued jobs wait instead of exhausting RAM.
Ready to run Get the complete application and its required dependencies in one Docker image.

Supported platforms

Platform Video Audio
YouTube YouTube ✅ ✅
TikTok TikTok ✅ ✅
Instagram Instagram ✅ ✅
Facebook Facebook ✅ ✅

Note: Public URLs work without account cookies. Age- or login-gated content may work after importing a current signed-in session under Settings → Integrations; platforms can still reject stale or revoked sessions.

Quickstart

Docker is the recommended way to run fetchly. The image (Docker Hub) bundles ffmpeg, yt-dlp, yt-dlp-ejs, and deno — nothing else to install.

Docker Compose

# compose.yaml
services:
  fetchly:
    image: giiibates/fetchly:latest
    container_name: fetchly
    restart: unless-stopped
    stop_grace_period: 20s
    ports:
      # Loopback until the admin account exists — a port published without a
      # host address is reachable from the whole network.
      - "127.0.0.1:8000:8000"
    environment:
      FETCHLY_SECRET_KEY: ${FETCHLY_SECRET_KEY:?generate with: openssl rand -base64 32}
    volumes:
      - ./data:/app/data
export FETCHLY_SECRET_KEY="$(openssl rand -base64 32)"
docker compose up -d

A fuller compose file with log rotation, a pinned timezone, trusted-proxy and port variables, and dropped container capabilities lives in docker/docker-compose.yml.

Open http://127.0.0.1:8000 and create an admin account in Settings → Security. Only then widen the port binding (0.0.0.0:8000:8000) or put fetchly behind a reverse proxy. stop_grace_period stays above the container's 15 s graceful shutdown so the SQLite WAL checkpoint completes.

Learn more

The fetchly documentation covers installation, configuration, reverse proxies, security, platform cookies, the API, and troubleshooting.


Buy Me A Coffee

Categories

Download Statistics

4,650
Total Downloads

Related apps

Links

Details

Repository
giiibates/fetchly:latest
Last Updated2026-09-27
First Seen2026-08-31

Runtime arguments

Web UI
http://[IP]:[PORT:8000]
Network
bridge
Shell
bash
Privileged
false
Extra Params
--restart=unless-stopped --stop-timeout 20 --security-opt no-new-privileges:true --cap-drop ALL --cap-add CHOWN --cap-add DAC_OVERRIDE --cap-add FOWNER --cap-add SETUID --cap-add SETGID

Template configuration

Secret KeyVariable

Required persistent key for sessions and anti-bot tokens. Generate with: openssl rand -base64 32. Keep it when updating the container.

Target
FETCHLY_SECRET_KEY
Web UI PortPorttcp

Host port for the fetchly Web UI. The initial setup is reachable from your LAN; create an admin account immediately.

Target
8000
Default
8000
Value
8000
Persistent DataPathrw

SQLite database, downloads, job files, cookies and caches. Keep this path when updating.

Target
/app/data
Default
/mnt/user/appdata/fetchly/data
Value
/mnt/user/appdata/fetchly/data
Behind HTTPSVariable

Set to 1 when a reverse proxy serves fetchly over HTTPS so session cookies are marked Secure.

Target
FETCHLY_BEHIND_HTTPS
Default
0|1
Value
0
Trusted Proxy IPsVariable

Comma-separated IPs or CIDRs of trusted reverse proxies. Set this to the proxy address as seen by the container; wildcard is rejected.

Target
FORWARDED_ALLOW_IPS
Default
127.0.0.1,::1
Value
127.0.0.1,::1
Log LevelVariable

Container log verbosity. Use debug only while troubleshooting.

Target
LOG_LEVEL
Default
info|debug|warning|error
Value
info
Worker Timeout (s)Variable

Gunicorn worker timeout in seconds.

Target
TIMEOUT
Default
60
Value
60