longjohnsilver1/releasarr

•Updated 5 months ago

Tool for automating torrent uploads to trackers

Image

8.5K

longjohnsilver1/releasarr repository overview

⁠Presentation

Releasarr is a self-hosted app to manage release folders for private trackers: scan content, enrich metadata, generate NFO and presentation text, and upload to trackers with configurable definitions. This Docker image is all-in-one: Redis, web UI, and background workers run in a single container. No separate services required.

⁠Features

Scan folders and detect content type (movies, TV shows, games, ebooks, music)
Enrich metadata via TMDB, RAWG, MusicBrainz, Google Books (API keys configured in the app)
Generate NFO and presentation text from tracker-specific templates
Upload to one or more trackers with configurable JSON definitions (optional FlareSolverr for Cloudflare)
Create torrents and hardlinks for cross-seed; optional qBittorrent integration

⁠Environment variables

Variable	Default	Description
`NODE_ENV`	`production`	Node environment.
`HOST`	`0.0.0.0`	Bind address for the web server.
`PORT`	`3000`	Port for the web server inside the container.
`DATABASE_URL`	`file:/config/db/app.db`	SQLite database path.
`REDIS_URL`	`redis://127.0.0.1:6379`	Redis URL (use this default for the all-in-one image).
`NUXT_SCAN_ROOT`	`/data`	Root folder for release scans. Put your release folders here.
`NUXT_TORRENT_OUTPUT_DIR`	`/data/.releasarr/torrents`	Where generated torrent files are stored.
`NUXT_HARDLINKS_DIR`	`/data/.releasarr/hardlinks`	Where hardlinks for cross-seed are created.
`NUXT_TORRENT_CLIENT_SAVE_PATH`	—	Data root path as seen by qBittorrent (the app appends `/.releasarr`).
`NUXT_PUBLIC_SITE_URL`	—	Public URL of the app (e.g. `https://releasarr.example.com`).
`NUXT_SESSION_COOKIE_SECURE`	`true`	Set to `false` if the app is served over HTTP only.
`TZ`	—	Timezone (e.g. `Europe/Paris`).

Seed defaults (optional) — Used on first run when the DB is created and seeded. Set them in your compose environment: (or env_file) so they are written to the DB; otherwise configure later in the app (Settings → API, Settings).

Variable	Default	Description
`APP_USERNAME`	`admin`	First user login.
`APP_PASSWORD`	`changeme`	First user password (change after first login).
`TMDB_API_KEY`	—	TMDB API key (movies/TV metadata).
`TMDB_LANGUAGE`	`en-US`	TMDB language code.
`RAWG_API_KEY`	—	RAWG API key (games metadata).
`TORRENT_CLIENT_URL`	`http://localhost:8080`	qBittorrent Web UI URL (use `http://host.docker.internal:8080` if qBittorrent is on the host).
`TORRENT_CLIENT_USERNAME`	`admin`	qBittorrent Web UI username.
`TORRENT_CLIENT_PASSWORD`	`adminadmin`	qBittorrent Web UI password.
`NFO_HEADER`	—	Default header for generated NFO files.
`DEFAULT_RELEASE_GROUP`	—	Default release group name.
`FLARESOLVERR_URL`	—	Optional FlareSolverr URL for Cloudflare-protected trackers.

⁠Volumes

Two bind mounts:

Example path	Container path	Description
`./config`	`/config`	SQLite DB and app config.
`./data`	`/data`	Releases root + `.releasarr` internals.

⁠Docker Compose example

services:
  releasarr:
    image: longjohnsilver1/releasarr:latest
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      NUXT_SESSION_COOKIE_SECURE: "false"
      NUXT_TORRENT_CLIENT_SAVE_PATH: "/home/user/data" # same as data volume but with absolute path (as seen by qBittorrent)
      TZ: "Europe/Paris"
    volumes:
      - ./config:/config
      - ./data:/data
    extra_hosts:
      - "host.docker.internal:host-gateway"

⁠Links

Source code: Codeberg — releasarr⁠

Tag summary

Recent tags

Content type

Image

Digest

sha256:4be5a3981…

Size

323.5 MB

Last updated

5 months ago

docker pull longjohnsilver1/releasarr