SABnzbd

Wiki

User Manual FAQ Contact Introduction Installation Configuration Scripts Advanced Topics Extensions for SABnzbd

Incorrect or missing information? Install from source

Guides for Windows and macOS

Specific guides to install from source are available for:


Linux platforms

Source

Get a local copy (clone) of the SABnzbd source from github or via git with:
git clone -b master https://github.com/sabnzbd/sabnzbd.git 

Python

SABnzbd 3.7.2 and higher requires Python 3.8 or higher.
Check python version with python3 --version.

Must-have Python modules

Python comes included with a Python Packages Manager (pip) on many platforms.
Which may be required to be updated to handle building/installing newer packages for your system.

Upgrade the python package manager and build modules:

python3 -m pip install --upgrade pip wheel
Install the Python module requirements from the SABnzbd source directory:
pip3 install --upgrade -r requirements.txt
If you plan to do development work, you might need the following OS packages:
pip3 install --upgrade -r builder/requirements.txt
pip3 install --upgrade -r tests/requirements.txt
On non-x86 linux platforms you may need to install:
python3-dev python3-setuptools python3-pip libffi-dev libssl-dev openssl-dev musl-dev cargo

If the sabctools (formerly called sabyenc) installation fails, read here.

Start SABnzbd by running:

./SABnzbd.py

Multi-language support

To enable multi-language support (and fix mistakes in English texts) you will need to run this command once before starting SABnzbd for the first time and after each major update:

python3 tools/make_mo.py

Must-have utilities

unrar

We recommend release 5.5 or higher your package manager or the official website.

par2

Available through package managers as par2, par2cmdline or via GitHub.
Optimized versions of par2 can also be installed, read more here.

Optional utilities

unzip

Any unzip command that supports passwords (via -P option) will function.
Can usually be installed via package managers, alternatively InfoZip's unzip program can be obtained here.

7zip

7zip can be obtained via package managers, the command that SABnzbd looks for is 7za or 7z.
The package is called 7zip or can be obtained from the official website.
p7zip was a modification of 7zip to provide linux support which has been abanonded.

nice

To adjust the CPU priority of external tools that SABnzbd runs (ex: par / unrar)

ionice

To adjust the disk priority of external tools that SABnzbd runs (ex: par / unrar)

notify-osd

NotifyOSD provides desktop pop-up notifications. Available through package managers as notify-osd.