NNTmux

NNTmux

Docker app from RapidMark's Repository

Overview

NNTmux Usenet indexer in a single container. Bundles MariaDB, Redis and Manticore plus the web UI, queue workers, scheduler and the tmux indexing engine. First run creates the database and admin user from the variables below, so fill in the NNTP and Admin settings before starting. Config, database and search data live in /config. NZBs and covers live in /data.

Readme

View on GitHub

NNTmux for Unraid

Single-container build of NNTmux. The upstream app image is built as-is, then MariaDB, Redis and Manticore are added and everything runs under s6-overlay.

service what
mariadb MariaDB 11.4, bound to 127.0.0.1
redis cache, sessions, Horizon queues
manticore search engine
web FrankenPHP on port 80
horizon queue workers
scheduler artisan schedule:work
indexer tmux processing engine, START_INDEXER=false to skip it

Volumes

  • /config holds .env, MariaDB, Redis, Manticore, Laravel storage and the install lock.
  • /data holds nzb/ and covers/, the parts that grow.

First run

The container refuses to start without ADMIN_USER, ADMIN_EMAIL, ADMIN_PASS (12+ chars), NNTP_SERVER, NNTP_USERNAME and NNTP_PASSWORD. It then writes /config/.env with an APP_KEY and a random DB password, creates the database and admin user, builds the Manticore tables and drops /config/install/install.lock. Expect a few minutes.

Container environment variables always win over /config/.env, so the Unraid template drives the common settings and .env holds the rest. Edit .env for API keys or anything the template does not expose, then restart.

Unraid

Add a container with template URL https://raw.githubusercontent.com/RapidMark/NNTmux/master/unraid/nntmux.xml, or copy nntmux.xml to /boot/config/plugins/dockerMan/templates-user/. The template passes --stop-timeout 120 so MariaDB gets a clean shutdown.

Building

cd unraid
make build     # nntmux-app:build from ../Dockerfile, then rapidmark/nntmux:dev
make lint

CI builds weekly and on pushes touching unraid/, then pushes rapidmark/nntmux:latest, :bookworm_<date> and :sha-<short>. Needs the DOCKERHUB_USERNAME and DOCKERHUB_TOKEN repo secrets.

Updating upstream

git fetch upstream
git merge upstream/master
git push

The image is whatever commit master is at, so the merge is the pin.

Install NNTmux on Unraid in a few clicks.

Find NNTmux in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for NNTmux Review the template variables and paths Click Install
Explore Unraid OS

Requirements

Usenet provider account (NNTP). First run needs ADMIN_USER, ADMIN_EMAIL, ADMIN_PASS (12+ chars) and the NNTP settings.

Categories

DownloadersTools > Utilities

Download Statistics

133
Total Downloads

Related apps

Explore more like this

Explore all
DownloadersUtilities apps

Links

Projectgithub.comSupportgithub.comDocker Hubhub.docker.comTemplateraw.githubusercontent.com

Details

Repository
rapidmark/nntmux:latest
Registry
https://hub.docker.com/r/rapidmark/nntmux
Last Updated2026-09-22
First Seen2026-09-23

Runtime arguments

Web UI
http://[IP]:[PORT:80]/
Network
bridge
Shell
bash
Privileged
false
Extra Params
--stop-timeout 120

Template configuration

WebUIPorttcp

Web interface port

Target
80
Default
8085
Value
8085
ConfigPathrw

Settings, database, Redis and Manticore data

Target
/config
Default
/mnt/user/appdata/nntmux
Value
/mnt/user/appdata/nntmux
DataPathrw

NZB files and cover images. Grows large, put it on the array if you like.

Target
/data
Default
/mnt/user/appdata/nntmux/data
Value
/mnt/user/appdata/nntmux/data
PUIDVariable

User id the services run as

Default
99
Value
99
PGIDVariable

Group id the services run as

Default
100
Value
100
TZVariable

Timezone, for example America/Chicago

Default
Etc/UTC
Value
Etc/UTC
Site URLVariable

URL you will use to reach the site, including port

Target
APP_URL
Default
http://localhost:8085
Value
http://localhost:8085
NNTP ServerVariable

Usenet provider hostname

Target
NNTP_SERVER
NNTP PortVariable

563 for SSL, 119 for plain

Target
NNTP_PORT
Default
563
Value
563
NNTP SSLVariable

true or false

Target
NNTP_SSLENABLED
Default
true
Value
true
NNTP UsernameVariable
Target
NNTP_USERNAME
NNTP PasswordVariable
Target
NNTP_PASSWORD
NNTP ConnectionsVariable

Connections your provider allows

Target
NNTP_CONNECTIONS
Default
10
Value
10
Admin UsernameVariable

Created on first run

Target
ADMIN_USER
Default
admin
Value
admin
Admin PasswordVariable

At least 12 characters. Used on first run only.

Target
ADMIN_PASS
Admin EmailVariable

Created on first run

Target
ADMIN_EMAIL
Start indexerVariable

Set false to run only the web UI without the tmux indexing engine

Target
START_INDEXER
Default
true
Value
true
MariaDB buffer poolVariable

InnoDB buffer pool size, raise on a box with spare RAM

Target
DB_INNODB_BUFFER_POOL_SIZE
Default
1G
Value
1G
TMDB API keyVariable
Target
TMDB_APIKEY
TVDB API keyVariable
Target
TVDB_APIKEY
OMDB API keyVariable
Target
OMDB_APIKEY
Fanart.tv API keyVariable
Target
FANARTTV_APIKEY
Trakt API keyVariable
Target
TRAKTTV_APIKEY