Skip to content

Installation

The installer handles Node.js, ffmpeg, HandBrake CLI, and DVD libraries automatically.

Supported platforms: Ubuntu/Debian (apt), Fedora/RHEL (dnf), Arch Linux (pacman), macOS (brew)

git clone https://git.opensourcesolarpunk.com/Circuit-Forge/discarr
cd discarr
sudo bash install.sh

The installer will ask whether to register a systemd service.

Installer options

Override defaults with environment variables:

sudo DISCARR_INSTALL_DIR=/opt/discarr \
     DISCARR_PORT=8603 \
     REGISTER_SERVICE=yes \
     bash install.sh
Variable Default Description
DISCARR_INSTALL_DIR /opt/discarr Where to install app files
DISCARR_USER discarr System user for the service
DISCARR_PORT 8603 Web UI port
REGISTER_SERVICE ask ask, yes, or no
SKIP_DEPS 0 Set to 1 to skip system dep installation

What gets installed

Dependency apt dnf pacman brew
Node.js 20 LTS NodeSource NodeSource nodejs node@20
ffmpeg + ffprobe ffmpeg ffmpeg (RPM Fusion) ffmpeg ffmpeg
HandBrake CLI handbrake-cli HandBrake-cli handbrake-cli handbrake
libdvdcss libdvd-pkg libdvdcss (RPM Fusion) libdvdcss libdvdcss
libdvdread libdvdread8 libdvdread libdvdread —
libdvdnav libdvdnav4 libdvdnav libdvdnav —

libdvdcss on Ubuntu

Ubuntu's libdvd-pkg builds libdvdcss from source using dpkg-reconfigure. The installer handles this automatically. Legal in most jurisdictions for personal use.

HandBrake on Fedora

Requires RPM Fusion. The installer enables it automatically when installing ffmpeg — HandBrake installs from the same repo.

Docker

Pre-built image — includes ffmpeg, ffprobe, HandBrake CLI, libdvd* libraries, and openssh-client:

docker run -d \
  --name discarr \
  -p 8603:8603 \
  -v ~/.config/media-postprocessor:/root/.config/media-postprocessor:ro \
  -v ~/.local/share/discarr:/root/.local/share/discarr \
  -v /path/to/media:/media \
  pyr0ball/discarr:latest

Docker Compose

services:
  discarr:
    image: pyr0ball/discarr:latest
    container_name: discarr
    ports:
      - "8603:8603"
    volumes:
      - ~/.config/media-postprocessor:/root/.config/media-postprocessor:ro
      - discarr-data:/root/.local/share/discarr
      - /path/to/media:/media
    restart: unless-stopped
    environment:
      - PORT=8603

volumes:
  discarr-data:

Media path

The /media mount must be the same path that Sonarr/Radarr can also see. If your arr apps run in Docker, make sure they share the same media volume or NFS mount.

Manual (from source)

Install system dependencies yourself (see table above), then:

git clone https://git.opensourcesolarpunk.com/Circuit-Forge/discarr
cd discarr

# Configure
mkdir -p ~/.config/media-postprocessor
cp api-keys.conf.example ~/.config/media-postprocessor/api-keys.conf
$EDITOR ~/.config/media-postprocessor/api-keys.conf

# Run
node server.js