# NZBGet

NZBGet is an Usenet-client written in C++ and designed with performance in mind to achieve maximum download speed by using very little system resources.

## Installation

- nzbget - daemon, with CLI, and web client listening on port `6789`.
- nzbget-svnAUR - Same as above, but the latest svn build.

## Configuring NZBGet

Copy the template configuration file to a custom directory:

    # mkdir /usr/local/share/nzbget
    # cp /usr/share/nzbget/nzbget.conf /usr/local/share/nzbget/nzbget.conf

Edit the copied `/usr/local/share/nzbget/nzbget.conf` config file to your own needs.

## Starting NZBGet

Note: The NZBGet package doesn't provide a systemd service file. You will have to start it manually instead.

- Running as root in console-mode:

      # nzbget -c /usr/local/share/nzbget/nzbget.conf -s

- Running as root in daemon-mode:

      # nzbget -c /usr/local/share/nzbget/nzbget.conf -D

NZBGet should now be accessible on http://localhost:6789.

## Running NZBGet under a different user

For better security it is better to run NZBGet under a different user. In the following example there is an user created named `nzbget`.

Edit the configuration file:

    /usr/local/share/nzbget/nzbget.conf

    DaemonUsername=nzbget
    MainDir=/home/user/Downloads/NZBGet
    UMask=0007

It may be necessary to set write permissions:

    # chown -R nzbget:nzbget /usr/local/share/nzbget
    # chmod -R 755 /usr/local/share/nzbget

Create and set permissions to the desired directories:

    # mkdir /home/user/Downloads/NZBGet
    # chown -R nzbget:nzbget /home/user/Downloads/NZBGet
    # chmod -R 770 /home/user/Downloads/NZBGet

Now `/home/user/Downloads/NZBGet` will be accessible for the user `nzbget` and for the `nzbget` group. Making the target directory world read/writable is highly discouraged (i.e. do not chmod the directory to 777). Instead, give individual users/groups appropriate permissions to the appropriate directories (e.g. by adding 'yourself' to the `nzbget` group).

Starting NZBGet as user `nzbget` in daemon-mode:

    $ sudo -u nzbget /usr/bin/nzbget -c /usr/local/share/nzbget/nzbget.conf -D

## Troubleshooting

### Default NZBGet credentials

The default credentials for NZBGet are `nzbget` as user and `tegbzn6789` as password. For security reasons it is recommended to change the default credentials.

### NZBGet crashes on start

This may happen when the user edited the NZBGet configuration by the Web-interface (located at http://localhost:6789), corrupting the configuration-file. Clean-up the configuration-file and restart the server/daemon again.

## See also

- NZBGet Documentation
- Performance Tips

Category:

- Internet applications