/docker-compose-usenet

Docker-powered usenet pipeline

The UnlicenseUnlicense

Automated Usenet Pipeline

Build Status

An automated Usenet pipeline with reverse proxy and auto-updating of services, predominantly using the popular linuxserver Docker images. Includes:

Requirements

  • Docker
  • Docker Compose
  • Domain of your own (usage of a free DDNS service such as DuckDNS is not advised or supported)

Usage

Setup

Using example.env, create a file called .env (in the directory you cloned the repo to) by populating the variables with your desired values (see key below).

Variable Purpose
CONFIG Where the configs for services will live. Each service will have a subdirectory here
DOWNLOAD Where SAB will download files to. The complete and incomplete dirs will be put here
DATA Where your data is stored and where sub-directories for tv, movies, etc will be put
DOMAIN The domain you want to use for access to services from outside your network
TZ Your timezone. List here.
HTPASSWD HTTP Basic Auth entries in HTPASSWD format (generate here)

Values for User ID (PUID) and Group ID (PGID) can be found by running id user where user is the owner of the volume directories on the host.

Traefik

  1. Create a folder called traefik in your chosen config directory. Everything below should be executed inside the traefik directory
  2. Run touch acme.json; chmod 600 acme.json
  3. Copy traefik.toml to the traefik directory in your config folder and replace the example email with your own

DDClient

If you have a static IP this isn't necessary, and you can simply remove the service entry for ddclient.

  1. Create a directory in your chosen config directory called ddclient
  2. Run touch ddclient.conf in the directory
  3. Use the protocol documentation to create a config for your chosen DNS provider

Running

In the directory containing the files, run docker-compose up -d. Each service should be accessible (assuming you have port-forwarded on your router) on <service-name>.<your-domain>. Heimdall should be accessible on <your-domain>, from where you can set it up to provide a convenient homepage with links to services. The Traefik dashboard should be accessible on monitor.<your-domain>.

Service Configuration

When plumbing each of the services together you can simply enter the service name and port instead of using IP addresses. For example, when configuring a download client in Sonarr/Radarr enter sabnzbd in the Host field and 8080 in the Port field. The same applies for other services such as NZBHydra.

Customisation

NZBGet

To use NZBGet instead of Sabnzbd, simply replace the sabnzbd service entry with the following:

nzbget:
  image: linuxserver/nzbget:latest
  container_name: nzbget
  hostname: nzbget
  ports:
    - "6789:6789"
  volumes:
    - ${CONFIG}/nzbget:/config
    - ${DOWNLOAD}/complete:/downloads
    - ${DOWNLOAD}/incomplete:/incomplete-downloads
    - ${DOWNLOAD}/watch:/watch
  environment:
    - PGID
    - PUID
    - TZ
  labels:
    traefik.enable: "true"
    traefik.port: "6789"
    traefik.frontend.rule: "Host:nzbget.${DOMAIN}"
    traefik.frontend.auth.basic: "${HTPASSWD}"
    com.ouroboros.enable: "true"
  restart: unless-stopped
Service customisation

To add a new volume mount or otherwise customise an existing service, create a file called docker-compose.override.yml.

For example, to add new volume mounts to existing services:

version: '3'

services:
  radarr:
    volumes:
      - ${DATA}/documentaries:/media/documentaries

  plex:
    volumes:
      - ${DATA}/documentaries:/media/documentaries

You can also add new services to the stack using the same method.

Notes / Caveats

Plex

Plex config may not be visible until you SSH tunnel:

  • ssh -L 8080:localhost:32400 user@dockerhost

Once done you can browse to localhost:8080/web/index.html and set up your server.

UnRAID Usage

Only tested on UnRAID 6.4.1+.

Installing Docker Compose

Add the following to /boot/config/go in order to install docker-compose on each boot:

COMPOSE_VERSION=$(curl -s https://api.github.com/repos/docker/compose/releases/latest | grep 'tag_name' | cut -d\" -f4)
curl -L https://github.com/docker/compose/releases/download/${COMPOSE_VERSION}/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

Persisting user-defined networks

By default, UnRAID will not persist user-defined Docker networks such as the one this stack will create. You'll need to enable this setting in order to avoid having to re-run docker-compose up -d every time your server is rebooted. It's found in the Docker tab, you'll need to set Advanced View to on and stop the Docker service to make the change.

UnRAID UI port conflict

You'll need to either change the HTTPS port specified for the UnRAID WebUI (in Settings -> Identification) or change the host port on the Traefik container to something other than 443 and forward 443 to that port on your router (eg 443 on router forwarded to 444 on Docker host) in order to allow Traefik to work properly.

Help / Contributing

If you need assistance, please file an issue. Please do read the existing closed issues as they may contain the answer to your question.

Pull requests for bugfixes/improvements are very much welcomed. As are suggestions of new/replacement services.