How to Upgrade from NZBGet v21.1 to the Latest NZBGet Version

If you’re still using NZBGet v21.1, it’s time to upgrade. The latest release includes improved performance, better extension support, and enhanced compatibility with modern systems.

To help you migrate smoothly, follow this guide tailored to your platform. Backups are strongly recommended before making any changes.

General Migration Instructions (All Platforms)

1. Backup your settings
   In the NZBGet Web UI:
   Settings > System > Backup Settings

   The backup config file will be downloaded to your browser’s downloads folder.

2. Stop all running NZBGet instances

3. Uninstall the old application

4. (Strongly recommended): Delete the old config file (nzbget.conf)

5. Install the latest version of NZBGet

6. Restore settings
   In the Web UI:
   Settings > System > Restore Settings

Windows

• Default config file location:
  C:\ProgramData\NZBGet\nzbget.conf

Steps:

1. Backup your settings.
2. Stop NZBGet completely.
3. Uninstall NZBGet from the Control Panel.
4. Delete nzbget.conf from the path above.
5. Install the new version from the official NZBGet site.
6. Open the new Web UI and restore your settings from the backup config file.

Linux (.run package)

• Config file location:
  {AppDir}/nzbget.conf

Steps:

1. Backup via Web UI or manually copy nzbget.conf
2. If your downloads folder is inside the NZBGet directory, back it up or move it temporarily to another location.
3. Delete the old NZBGet installation directory and all contents.
4. Install the latest NZBGet version
5. Restore your config file and download folder if needed.

macOS

• Config file location:
  ~/Library/Application Support/NZBGet/nzbget.conf

Steps:

1. Delete NZBGet.app from the Applications folder.
2. Copy the new NZBGet.app to Applications.
3. No settings will be lost—the config file remains untouched.

For platform-specific migration assistance, refer to the related discussion on Github.

Synology NAS (Migrating from SynoCommunity Package)

Steps:

1. Backup your settings from the Web UI.
2. Completely remove the old SynoCommunity package. Choose to wipe settings.
3. Install the new .spk package for your platform from nzbgetcom.
4. Restore your settings via the Web UI.
5. Important: If your MainDir changed during restore settings, you may need to adjust permissions for the nzbget user. See the Synology README for details.

Docker

• Config file location:
  Docker -> config volume mount -> nzbget.conf

Direct Image Migration:

Change image in docker-compose.yml to nzbgetcom/nzbget:TAG or ghcr.io/nzbgetcom/nzbget:TAG, where TAG can be:

• latest for stable releases
• testing for development versions

Special Notes:

If migrating from linuxserver/nzbget, nzbget-ng, or switching from testing to latest, you have to remove the ArticleReadChunkSize string from the config file. ArticleReadChunkSize is supported from NZBGet v22.

Check unpacking settings under Settings > Unpack:

• UnrarCmd should be unrar
• SevenZipCmd should be 7z

Extensions:

The new image bundles Python 3.11. Make sure your extensions are compatible with this Python version.

Updated versions of the following are available:

• FailureLink
• VideoSort
• FakeDetector

Full Migration (Clean Start):

1. Backup your settings via the Web UI: Settings > System > Backup Settings
2. Stop and remove the old container
3. Delete nzbget.conf
4. Switch to the new image (nzbgetcom/nzbget:latest or testing)
5. Start the container to generate a fresh config
6. Restore your settings via the Web UI: Settings > System > Restore Settings

See here for more help.

Troubleshooting Docker Migration

If the new Docker image fails to run, provide the following in your support request in the NZBGet Discord Channel:

• Your system details (OS, architecture, NAS model, etc.)
• Docker version
• Docker logs