NZBGet Port Settings and Access Guide
NZBGet provides a web-based interface that allows you to manage Usenet automation easily from any browser. By default, the interface is accessible through a specific port, but depending on your setup, you may need to change or troubleshoot it.
This guide explains how the NZBGet port works, how to modify it, and how to avoid common access issues.
Default NZBGet Port
NZBGet uses the following port for its Web interface:
- Username: 6789
- Access URL: http://<device-ip>:6789
This port is used across most installations, including:
- Native desktop installations (Windows, Linux, macOS)
- Docker containers (e.g., LinuxServer.io image)
- NAS systems like Synology and QNAP
- Media automation platforms like Unraid or DietPi
How to Change the NZBGet Port
There are two common ways to change the port:
Option 1: Change via Web Interface (If Accessible)
- Go to http://localhost:6789 and log in.
- Click on Settings.
- Go to Security → ControlPort.
- Change the value from 6789 to your desired port.
- Save all changes.
- Restart NZBGet.
⚠️ After restarting, you’ll need to use the new port in your browser: http://localhost:<new-port>
Option 2: Change via Configuration File
If the Web interface isn’t accessible:
- Open the nzbget.conf configuration file.
- Common paths:
- /etc/nzbget.conf (Linux)
- /config/nzbget.conf (Docker)
- Common paths:
- Look for this line: ControlPort=6789
- Replace 6789 with your desired port (e.g., 8080).
- Save and restart NZBGet.
Port Already in Use?
If another application is using port 6789, you might see errors or be unable to access NZBGet.
How to Check:
On Linux/macOS: sudo lsof -i :6789
On Windows (Command Prompt): netstat -aon | findstr :6789
If another process is using the port, change NZBGet to a different one (e.g., 6790) using the steps above.
Using NZBGet Behind a Reverse Proxy
If you’re running NZBGet alongside a Web server (like Nginx or Apache), it’s common to reverse proxy access instead of exposing the port directly.
Basic Nginx Proxy Example:
location /nzbget/ {
proxy_pass http://localhost:6789/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
This allows access at http://yourdomain.com/nzbget/
while keeping NZBGet on its default port.
Firewall and Router Considerations
If you can’t reach NZBGet from another device on your network:
- Check firewall settings to make sure port 6789 (or your custom port) is allowed.
- On routers, avoid port forwarding unless NZBGet access is restricted to LAN.
- For Docker users, confirm the port is published correctly with -p 6789:6789.
NZBGet Port Overview
Purpose | Port | Where to Configure |
---|---|---|
Web Interface (default) | 6789 | nzbget.conf or Web UI → Security |
Docker mapped port | 6789 (host-side) | -p flag in docker run |
Reverse proxy access | varies | Nginx/Apache config |
Troubleshooting Port Access
Issue: Can’t access http://localhost:6789
Fix:
- Confirm NZBGet is running
- Verify the port hasn’t been changed
- Check firewall/antivirus blocking
- Use docker ps to check port mapping if in a container
Issue: Port conflict
Fix: Change NZBGet’s port or shut down the other service
Issue: Secure remote access
Fix: Run behind a reverse proxy and use HTTPS
Introduction
Installation manuals
- Installation on Windows
- Installation on Windows via WinGet
- Installation on macOS
- Installation on macOS via Homebrew
- Installation on Linux
- Installation on Docker
- Installation on Docker - LinuxServer.io version
- Installation on Android
- Installation on Synology
- Installation on QNAP
- Installation on other NAS devices
Building manuals
Configuration
- Backup And Restore Settings
- Performance Tips
- Choosing Cipher
- Behind Other Web Server
- TLS certificate verification
- What is the Default NZBGet Password?
- NZBGet Docker Setup Guide
- NZBGet Port Settings and Access Guide
- How to Configure NZBGet: Complete Setup Guide
- What Is Usenet?
- NZBGet 502 Error: Quick Fix Guide
- How to Upgrade from NZBGet v21.1 to the Latest NZBGet Version
- Slow NZBGet Speeds? Here’s How to Fix It
- NZBGet Performance Optimization Guide
- NZBGet Path and Folder Structure Guide
- How to Link NZBGet with Sonarr, Radarr, and Other Tools
Usage
- Quick Filter
- Keyboard Shortcuts
- RSS and duplicate check
- VideoSort
- Console Mode
- Command Line Reference
- Performing Speed Tests
Development
Extensions
- Extension Scripts
- Post-processing scripts
- Scan Scripts
- Queue Scripts
- Scheduler Scripts
- Feed Scripts
- API reference
News server setup
- Astraweb
- BlockNews
- Cheapnews
- EasyNews
- Eweka
- FreeDiscussions
- Frugal Usenet
- GigaNews
- NewsDemon
- Newsgroup Ninja
- NewsgroupDirect
- Newshosting
- Pure Usenet
- SunnyUsenet
- Supernews
- theCubeNet
- ThunderNews
- TweakNews
- Usenet.Farm
- UsenetExpress
- UsenetServer
- UseNext
- ViperNews
- XLned
- XS News