Quick Start¶

Get fetchly running in under five minutes with Docker.

Prerequisites¶

• A Linux host with Docker (or Docker Desktop on macOS/Windows)
• A free TCP port — 8000 in the examples below
• Roughly 2 GB of free disk space for the image, plus whatever your downloads need

1. Generate a secret key¶

FETCHLY_SECRET_KEY signs the session cookie and the invisible anti-bot token. fetchly refuses to start without it.

export FETCHLY_SECRET_KEY="$(openssl rand -base64 32)"

2. Start the container¶

docker run -d \
  --name fetchly \
  --restart unless-stopped \
  -p 8000:8000 \
  -e FETCHLY_SECRET_KEY \
  -v "$PWD/data:/app/data" \
  giiibates/fetchly:latest

services:
  fetchly:
    image: giiibates/fetchly:latest
    container_name: fetchly
    restart: unless-stopped
    ports:
      - "8000:8000"
    environment:
      FETCHLY_SECRET_KEY: ${FETCHLY_SECRET_KEY:?generate with: openssl rand -base64 32}
    volumes:
      - ./data:/app/data

docker compose up -d

3. Open the UI¶

Navigate to http://127.0.0.1:8000.

4. Enable authentication¶

1. Open Settings → Security
2. Enter an admin username and password (twice)
3. Save — storing credentials switches the login on

Credentials live in the database only; no environment variable can set or override them. See Authentication for the session model.

5. Download something¶

1. Paste a media URL into the input on the dashboard
2. fetchly resolves the title, thumbnail, and duration
3. Pick Video or Audio and the quality you want
4. Submit — the job appears in the list and streams progress live

First Steps in detail

Verify the deployment¶

curl -fsS http://127.0.0.1:8000/health

{"status":"ok"}

The container also ships a HEALTHCHECK that probes the same endpoint every 30 seconds, so docker ps reports healthy once the app is up.

Where to next¶