Incorrect or missing information? SABnzbd as a Windows Service
Running SABnzbd as a Windows Service can be helpful to those needing the program to operate in an "always on" state. When installed this way, SABnzbd will start automatically as soon as Windows starts, even when no user account is logged in, and will remain running even when all users have logged out.
Two executables are necessary to install SABnzbd as a service:
SABnzbd-service.exe (the main program) plus a "helper" service:
SABnzbd-helper.exe. Both will need to be installed via a DOS command line that has administrative (elevated) privileges.
NOTE While the functionality of SABnzbd is generally the same when running as a service, there are some restrictions and limitations. Most importantly, you will need to take additional steps after installing the service if you use network shares for your download folders. Details on these steps, and other considerations when running SABnzbd as a service, can be found after the basic installation instructions, below.
The following procedure will install SABnzbd as a service using the same settings used by the graphical web-based interface. This should satisfy most users' needs, but if you need to run the service with different settings than those used in the web interface, please read through the "Specifying additional options" section that follows this section before proceeding.
Open a DOS window with Administrative (elevated) privileges
Windows 7, Vista, XP
Click your Windows Start button.
Click All Programs
Right click "Command Prompt" and choose "Run as Administrator" in the drop-down menu.
Windows 8, 10
Click your Windows Start button
Right click "Command Prompt" in the search window and choose "Run As Administrator" in the drop-down menu that appears.
- Windows 7, Vista, XP
Access the directory in which you installed SABnzbd.
If you installed SABnzbd in its default location (
C:\Program Files (x86)\SABnzbd) just type (or paste) the below command exactly as it appears, then hit the RETURN key. If you installed it to a different drive or folder, however, make sure to edit the path to reflect that location.
cd "C:\Program Files (x86)\Sabnzbd"
Install the helper service, set it to automatically start, and launch it, by typing or pasting the following lines into the DOS command window and hitting RETURN after each.
SABnzbd-helper.exe install sc config SABhelper start= auto net start SABhelper
Install the SABnzbd-service, set it to automatically start, and launch it, by typing or pasting the below commands into the DOS command window and hitting RETURN after each.
SABnzbd-service.exe -f "%localappdata%\sabnzbd\sabnzbd.ini" install sc config SABnzbd start= auto net start SABnzbd
NOTE The first command uses the
%localappdata%system variable to point to the LOCAL folder within your user's APPDATA folder, which should work on all versions of Windows. If for some reason that does not work on your system and you get a
sabnzbd.ini file not foundtype error you will need to replace the path portion of the above command to explicitly point to your
sabnzbd.inifile within your
NOTE If you used Powershell instead of Command Prompt this will not work!
That’s it! SABnzbd is now installed and running as an "always on" service! If all you need is to run SABnzbd as a service using the same settings used in the SABnzbd web interface-and you are not using network shares for your downloaded files-your work here is done.
However, if you want to customize the way that the service runs, or if you need to have SABnzbd access shared drives across the network, please read through the following sections for further information.
- NOTE SABnzbd will not present an icon in the Notification (lower right) area of the Windows screen when run as a service. This will not affect normal operation of the software.
- NOTE The Windows firewall will not warn you if it blocks the SABnzbd-service.exe as it does when blocking SABnzbd when running "normally", so you may need to add it to the firewall exception list using the normal procedures for your version of Windows if you run into an access problem. However, if you have already run SABnzbd successfully before installing it as a service, using the same port number, it is likely the exception will already be in effect.
- NOTE Before upgrading SABnzbd, it is recommended you stop both services to ensure there are no problems overwriting busy files. See the section below for details on stopping the service via the command line or through the Windows Service Manager.
Specifying additional options
By default, installing SABnzbd as a service (as detailed in step 4 of the above installation instructions) will cause it to run using the same settings used by the SABnzbd web interface on your system.
You can, however, override many of these settings with command line parameters. Simply add the pertinent command to the line that installs the SABnzbd service. Be aware that not all of the available command line options are appropriate when SABnzbd is running as a service—for instance, parameters like
–b (start browser) will be ignored even if specified.
NOTE Any parameter you set in the command line will override the equivalent parameter in the web interface and any changes to the interface settings will be ignored by the service for that parameter. For parameters not set through the command line, the service will use whatever was set in the GUI at the time the service is launched or updated.
For example, the following will install the SABnzbd service with the
-s host:port command to reflect a different server address:
SABnzbd-service.exe -f %localappdata%\sabnzbd\sabnzbd.ini –s 127.0.0.1:8081 install
In this example, the SABnzbd service will continue to use the specified port (8081) even if you subsequently specify a different port within the web interface. You would need to reinstall the service by re-entering the above command without the
-s 127.0.0.1:8081 argument to have the SABnzbd service once again go back to using the value set in the web interface.
Updating the service settings
Each time the SABnzbd service starts, it reads the SABnzbd ini file for configuration options. If you change settings within the SABnzbd web interface you can force the service to reread the ini file by typing the following the command in an elevated DOS command window after changing directories to the SABnzbd folder. Of course, you can also simply reboot the computer to cause the service to restart and reread the ini file again.
SABnzbd-service.exe -f %localappdata%\sabnzbd\sabnzbd.ini update
Removing the services
To completely remove the SABnzbd services, follow steps 1 and 2 in the Installation instructions above to open an elevated DOS command window and access the SABnzbd folder, then type or paste the following commands into it, hitting RETURN after each.
SABnzbd-service.exe remove SABnzbd-helper.exe remove
Start the services
NOTE The helper service should always be started AFTER the main SABnzbd-service.
net start SABnzbd net start SABhelper
Stop the services
net stop SABnzbd net stop SABhelper
Enabling Network Share Access
By default the SABnzbd service will be installed to run as the "Local System" account. This allows full access to local hard drives, but not to network shares. If you are using network shares within SABnzbd to save or process your downloads, the main SABnsdb-server service must run as a local user account with network privileges instead of "Local System". Here’s how to make that change:
- Install SABnzbd as a service using the instructions in the above Installation section.
- Launch the Windows Service Manager utility. (Typically that’s done by typing SERVICES into your Windows Start menu’s search and choosing SERVICES from the results list)
- In the Windows Services Manager, find the SABnzbd-service (it will be displayed as "SABnzbd Binary Newsreader") in the list of services and double-click it to access its settings.
- Click the Logon tab.
- Specify a different "Log on" account. (Make sure it is one that has administrative privileges and access to network shares).
- Apply the changes and close the Service Manager window.
NOTE When using network shares with the SABnzbd service, you must use network (UNC) paths (
\\server\share) instead of drive letters (
NOTE Even after doing the above to enable network share access, you will still be restricted to local drives only for the admin, log and incomplete folders due to limitations in those functions. Make sure, in your SABnzbd web interface configuration that those folders are not pointing to network shares.