You are using an unsupported browser. Please update your browser to the latest version on or before July 31, 2020.
Home > Newsreader Setup Guides > NZBGet on Linux
NZBGet on Linux
print icon

Linux installations are an easy process as NZBGet provides installers for Linux which require only Linux kernel 2.6 or later with no other library dependencies. This allows the NZBGet installer to work for most Linux installations including NAS, media players, WLAN routers, and other devices (even Chromebooks). The installer based installation process is described below. Please review the installation on POSIX guide if you prefer to self compile. 

Automatic installation

  1. Download the installer package from the NZBGet Download page

    1. If you have an up to date version of wget you can additionally download the installer directly on your device with the following command:

      1. wget
  2. Once downloaded start the installer from terminal with the following command:

    1. sh

Customized installation

  1. NZBGet installs the directory nzbget in the current directory. If you wish you can specify another directory using parameter --destdir:

    1. sh --destdir /path/to/install/nzbget
  2. CPU architecture is automatically detected by the installer. If you wish to change this setting, the architecture can be specified with parameter --arch <CPU-ARCH>:

    1.  sh --arch armhf
  3. Use parameter -h to get the list of supported CPU architectures.

  4. If you want to extract all files from the installer use parameter --unpack. All files included will be unpacked and no configuration will be performed.


  1. Begin testing by starting NZBGet in console server mode. In this mode you can see any errors as they happen in the terminal window. 

    1. <nzbget-directory>/nzbget -s
  2. If you get an error like “Can not open terminal” this is because NZBGet is in curses mode and it can’t determine the proper configuration. 

  3. To debug you can start NZBGet in output mode log or color:

    1. <nzbget-directory>/nzbget -s -o outputmode=log   
  4. Alternatively you can set the TERM variable:

    1. TERM=linux <nzbget-directory>/nzbget -s
  5. Once complete open the URL http://ip-address-of-linux-machine:6789, this will launch the NZBGet web-interface. 

  6. Enter the default login credentials

    1. Username: nzbget

    2. Password: tegbzn6789

  7. Go to settings and check options in the PATHS menu selection on the left side menu.

Restoring configuration

If you want to reuse a configuration file from another NZBGet installation review our guide on backing up and restoring settings.

Starting on boot

  1. To run NZBGet in the background as daemon (service) use the command -D instead of -s:

    1. <nzbget-directory>/nzbget -D
    2. Please note: you will not see any output of this command. 

    3. Add this line to the init scripts of your system. 

  2. Then add a shutdown line to the shutdown scripts:

    1. <nzbget-directory>/nzbget -Q

Please note that some systems (for example Synology NAS) offer easy scheduler configuration for tasks executed on system boot. In this event simply add the following command in the scheduler. 

<nzbget-directory>/nzbget -D 


On NZBGet installations that use the universal installer automatic updates are supported in the web-interface: Settings -> SYSTEM -> Check for updates.

To preserve your configuration and update NZBGet if the automatic update doesn’t function properly, you can download the installer with parameter 

--destdir </path/to/nzbget/directory>
0 out of 0 found this helpful

scroll to top icon