Difference between revisions of "SABnzbd"

From ArchWiki
Jump to: navigation, search
m (I'm quite sure the original editor intended this to be "sabnzbd.service" not "systemd.service"...)
(systemd: A little note about initial use and setup which may be quite beneficial for first-time users.)
Line 13: Line 13:
  
 
{{ic|start}} and {{ic|stop}} are direct, {{ic|enable}} and {{ic|disable}} configure automatic starting of the service during boot. For more information, refer to the [[Systemd]] article.
 
{{ic|start}} and {{ic|stop}} are direct, {{ic|enable}} and {{ic|disable}} configure automatic starting of the service during boot. For more information, refer to the [[Systemd]] article.
 +
 +
It is recommended to run through the initial setup wizard after starting the service by going to 127.0.0.1:8080 in your favourite web-browser. This initial setup should be enough to get SABnzbd working correctly for regular users. Users wanting HTTPS access are recommended to read further on in [https://wiki.archlinux.org/index.php/SABnzbd#enabling_https enabling https].
  
 
=== enabling https ===
 
=== enabling https ===

Revision as of 04:20, 21 October 2012

SABnzbd is an Open Source Binary Newsreader written in Python.

It's totally free, incredibly easy to use, and works practically everywhere. SABnzbd makes Usenet as simple and streamlined as possible by automating everything we can. All you have to do is add an .nzb. SABnzbd takes over from there, where it will be automatically downloaded, verified, repaired, extracted and filed away with zero human interaction.

Installation

Install sabnzbdAUR from the Arch User Repository.

Configuration

systemd

SABnzbd comes with a system service file, this can be used to control the daemon as follows:

#systemctl {start,stop,enable,disable} sabnzbd.service

start and stop are direct, enable and disable configure automatic starting of the service during boot. For more information, refer to the Systemd article.

It is recommended to run through the initial setup wizard after starting the service by going to 127.0.0.1:8080 in your favourite web-browser. This initial setup should be enough to get SABnzbd working correctly for regular users. Users wanting HTTPS access are recommended to read further on in enabling https.

enabling https

enabling https is a threefold process:

  • edit /opt/sabnzbd/sabnzbd.ini and set enable_https to 1
  • copy /usr/lib/systemd/system/sabnzbd.service to /etc/systemd/system/ then edit it and set PIDFile to /run/sabnzbd/sabnzbd-9090.pid
  • reload systemd with # systemctl --system daemon-reload

You should now be able to start sabnzbd with SSL support.

using a custom port

Using a custom port is similar to using https:

  • edit /opt/sabnzbd/sabnzbd.ini and set port in [misc] section to the port you wish to use.
  • copy /usr/lib/systemd/system/sabnzbd.service to /etc/systemd/system/ then edit it and set PIDFile to /run/sabnzbd/sabnzbd-yourport.pid where yourport is the same as set in the first step.
  • edit /etc/conf.d/sabnzbd_systemd and set SABNZBD_PORT to the port set in the first step.
  • reload systemd with # systemctl --system daemon-reload

You should now be able to start sabnzbd with a custom port.

Troubleshooting

systemd times out when starting SABnzbd with https enabled

When faced with the following:

[user@host ~]$ sudo systemctl start sabnzbd.service
Job failed. See system journal and 'systemctl status' for details.

[user@host ~]$ sudo systemctl status sabnzbd.service
sabnzbd.service - SABnzbd binary newsreader
	  Loaded: loaded (/usr/lib/systemd/system/sabnzbd.service; disabled)
	  Active: failed (Result: timeout) since Tue, 25 Sep 2012 20:10:47 +0200; 9s ago
	  CGroup: name=systemd:/system/sabnzbd.service

It's likely that you've forgotten to edit sabnzbd.service to reflect the proper PID file as mentioned in enabling https.

External Links