Movies, shows and music in one app instead of Radarr, Sonarr and Lidarr, several versions per title.
4.7K
Movies, shows and music in one self-hosted app. A movie or a show can have several versions, such as Full HD and 4K; music has one version for now. One app instead of Radarr, Sonarr and Lidarr side by side.

The screenshots show a throwaway demo instance with a few movies, shows and artists and made-up releases. Posters and covers in them are placeholder artwork.
/api/v1) with keys, an event feed and webhooks.![]() | ![]() |
![]() | ![]() |
![]() | ![]() |
![]() | ![]() |
![]() |
docker compose up -d
The bundled docker-compose.yml pulls ghcr.io/derkezorm/nexcrate:latest. Open
http://<your-host>:8390 and create the account.
⚠️ Whoever reaches a fresh installation first can claim it. Until the account exists, anybody who can open the page can create it, and it is the only account there is. Create it right after the first start, before the port is reachable from other networks. Once the account exists, the setup route is closed for good.
There is one account and no other way back in. Whoever controls the server sets a new one:
docker exec -it nexcrate python -m app.cli reset-password
It asks for the new password twice without showing it, and ends every session.
Settings › System › Sign-in has three cards. Sign-in: the switch for the sign-in with a
password and the public address. Sign-in providers: every provider that speaks OpenID
Connect (authentik, Microsoft Entra ID with common or organizations, Keycloak, Authelia,
Pocket ID), each with a button on the sign-in page and its own redirect address
(/api/oidc/<short name>/callback). authentik in one step: enter the address of authentik and
an API token, and nexcrate creates the signing key, the provider and the application, fills in
the entry and binds the application to the token's own user, so authentik lets nobody else
through. The token is used for this setup only and not stored. Rather without a token: download
the blueprint there, apply it in authentik and enter client ID and secret in the form.
nexcrate never registers an address it guessed: the redirect address at authentik is built from
the public address. While there is none, the card suggests the address your browser uses right
now ("Use it and set up", or "Use it only" to just keep it), and it warns when the server sees
another scheme or host than the browser, which is what a reverse proxy that ends TLS does when
nexcrate does not believe its X-Forwarded-Proto. Changing the public address later asks first
when authentik or a provider you entered by hand still knows the old redirect address, and the
card says so until the button has run again.
Behind a reverse proxy that ends TLS nexcrate takes the scheme (X-Forwarded-Proto) only
from the addresses named in FORWARDED_ALLOW_IPS (a comma separated list of addresses or
networks; * trusts every sender, so only behind a proxy nobody can bypass). Out of the box the
list is empty and nobody is believed. Name the address your proxy connects from, for example the
gateway of the Docker network, or 127.0.0.1 for a proxy on the same host with host networking.
nexcrate takes the rightmost value, the one your proxy wrote, whatever its case, and only http
or https.
Then link your account under Settings › System › Account › Sign-in providers: nexcrate asks for
its password and sends you to the provider once. One identity per provider opens nexcrate from
then on; every other identity is turned away, however the provider is set up. A provider can be
trusted with the second factor (the default) or not; then nexcrate asks for its own code after
the provider too. Once linked, the sign-in with a password can be switched off. If the provider
is ever gone, start nexcrate with NEXCRATE_PASSWORD_LOGIN=1 to open it again.
Coming from nexcrate 0.5 to 0.8: the provider of the settings becomes the entry "oidc" with its
link at the first start, and its redirect address /api/oidc/callback keeps working.
Settings › System › Account › "Second factor": after the password, nexcrate asks for a code from an authenticator app. Eight recovery codes are shown once. A sign-in through a provider asks for no code while the provider is trusted with the second factor (the default). Lost the phone and the codes?
docker exec -it nexcrate python -m app.cli reset-second-factor
Everything lives in /data (./data next to the compose file): the database, the secret key,
the logs and the backups (data/backups/).
⚠️
/databelongs on a local disk, never on an SMB or NFS share. SQLite's locking does not work reliably over network file systems, and that is how it loses data. On a NAS use a path on an internal volume, not a mounted share.
Back up secret.key together with the database. Stored credentials, such as API keys of other
programs, are encrypted with it; without it they have to be entered again.
nexcrate files into folders it can see inside its container, and you choose them from a list; there is no path to type. Mount the folder that holds your downloads and your media, for example:
volumes:
- ./data:/data
- /srv/data:/media
/data is nexcrate's own and is never offered as a media folder.
⚠️ Hardlinks work only inside one mount. Keep the downloads of your download clients and your media folders below one host folder and mount that folder once. With two mounts, even of the same disk, every torrent is copied and takes its space twice.
nexcrate: a
category in SABnzbd and qBittorrent, which nexcrate creates; any category in NZBGet, which takes
one without setup; a subfolder and, from version 4, a label in Transmission; a label in Deluge,
whose Label plugin nexcrate switches on./data instead of /media, nexcrate finds the finished download and asks once to confirm the
mapping.nexcrate category of a download client
yourself shows under Problems and is assigned the same way..nexcrate-recycle inside its root
folder, seven days by default, and can be taken back from Settings, Files.Every title nexcrate owns carries a small file release.nex in its folder (for shows in every
season folder, for albums in the album folder): the TMDB, IMDb or MusicBrainz number and per
version the file, its quality and release. Should the database ever be lost, nexcrate reads the
library back from these files without guessing. Plex, Jellyfin and Emby ignore the file.
Settings, System, "Backups". nexcrate copies its database weekly at night (or daily, monthly or
never), before every schema change, and when you ask. Download turns a copy into an
AES-encrypted ZIP with the database and secret.key, protected by a password you choose.
Restore takes such an archive and restarts nexcrate, which swaps it in before anything opens
the database; this needs a restart policy such as restart: unless-stopped, which the bundled
docker-compose.yml sets.
All optional, see .env.example and docker-compose.yml.
| Variable | Default | Meaning |
|---|---|---|
NEXCRATE_DATA_DIR | ./data | Database, key, logs, backups |
NEXCRATE_SECRET_KEY | generated in data/secret.key | Key for stored credentials |
NEXCRATE_COOKIE_SECURE | auto | auto follows the scheme of each request, on for a reverse proxy that ends TLS, off never |
NEXCRATE_LOG_LEVEL | empty | Fixes the log mode: quiet, normal, detailed, trace |
NEXCRATE_PORT | 8390 | Port inside the container |
NEXCRATE_URL_BASE | empty | Serve nexcrate under a sub path such as /nexcrate; /api/health also answers at the root |
NEXCRATE_PASSWORD_LOGIN | empty | 1 opens the sign-in with a password even when it was switched off for the providers |
NEXCRATE_PUBLIC_URL | empty | The address people reach nexcrate at, sub path included, when Settings › System › Sign-in names none; providers send the browser back there |
FORWARDED_ALLOW_IPS | empty (nobody) | The proxies nexcrate believes when they say X-Forwarded-Proto: https (comma separated addresses or networks, * for all); needed behind a reverse proxy that ends TLS, see Sign-in through authentik |
The log is in data/logs/ and in the interface, with download. There are four modes: quiet,
normal, detailed and trace; the two deep ones switch back to normal after 30 minutes,
2 hours or 8 hours. Every answer carries an X-Request-Id header that finds the lines of that
request. Secrets are masked before a line is written.
The interface uses the same API anybody can use. Documentation: /api/docs, the OpenAPI
document: /api/openapi.json. Requests that change something need the header
X-Requested-With: nexcrate.
Other programs use /api/v1, a contract that stays stable while the routes of the interface
follow its pages. It opens with a key from Settings, System, API keys, sent as
Authorization: Bearer <key>. A key is shown once and nexcrate keeps only its hash. Three
scopes: read (versions, titles and their state, seasons and episodes, the queue, problems,
history, the calendar, ratings, an event feed also as Server-Sent Events), request (request
titles, take requests back, freeze, move files into the recycle bin, ask for a search) and
operate (retry, remove, clear and assign the files of a stuck download). A program can also
ask to be connected (POST /api/v1/pairing) and collect its key once the owner confirms.
Webhooks send the same events signed with HMAC-SHA256.
Bazarr only knows Radarr and Sonarr, so nexcrate answers it as both. Switch it on under Settings,
System, Bazarr and Lingarr, make a key with nothing but read under API keys, and enter nexcrate in Bazarr
twice, under Radarr and under Sonarr, with the same address, port and key:
| In Bazarr | Base URL |
|---|---|
| Radarr | /bazarr/radarr |
| Sonarr | /bazarr/sonarr |
With NEXCRATE_URL_BASE the sub path comes first, for example /nexcrate/bazarr/radarr. Bazarr
keeps a live connection and hears of a new or replaced file within seconds.
Lingarr translates subtitles and, like Bazarr, only knows Radarr and Sonarr. It answers from
its own addresses, with the same switch and the same kind of key: in Lingarr under Settings,
Integrations, enter nexcrate instead of Radarr and Sonarr, with a key that has nothing but read
in both fields.
| In Lingarr | URL |
|---|---|
| Radarr | http://<nexcrate>:8390/lingarr/radarr |
| Sonarr | http://<nexcrate>:8390/lingarr/sonarr |
With NEXCRATE_URL_BASE the sub path comes first, for example /nexcrate/lingarr/radarr.
Lingarr picks up new movies and episodes on its next sync.
Backend on port 8390:
cd backend
python -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt
NEXCRATE_DATA_DIR=../data-dev .venv/bin/python -m uvicorn app.main:app --port 8390 --reload
Frontend on port 5390, talking to the backend under /api:
cd frontend
npm ci
npm run dev
TheXEM, MusicBrainz, AcoustID, ListenBrainz and the IMDb ratings can be switched off under Settings, Online services. Once a day nexcrate asks GitHub for its newest release; nothing but the request itself goes out, and it can be switched off on the About page.
Content type
Image
Digest
sha256:948a9822c…
Size
140.3 MB
Last updated
1 day ago
docker pull derkezorm/nexcrate