mirror
/
Sonarr
mirror of https://github.com/Sonarr/Sonarr
1
0
Fork 0
Code Issues Releases Wiki Activity
Page: Updating
Pages
Anime naming scheme AppData Directory Asking for Help Backup and Restore Cannot install update because startup folder is not writable by the user Command Line Options Completed Download Handling Configuration Custom Lists Custom Post Processing Scripts Delay Profiles Disable Authentication Downloads and Importing FAQ Failed Download Handling Forgot my Password Health Checks Home Implementing a Torznab indexer Indexer Integration Indexer Seed Ratio Installation (v3 beta) Fedora 31 Installation CentOS 7 Installation CentOS 8 V3 Beta Installation CentOS 8 Language Profile Log Files Logging and Log Files Manual Episode Search Trace Log Manual Episode Search XML Output Manually Triggering Imports Master Migration Monitoring Series and Episodes Problematic Shows Profiles PushOver Quality Profile RSS Sync Recovering from a Failed Update Release Branches Reverse Proxy Reverse symlink script for Connect SSL Searches Indexers and Trackers Sonarr notifications in Slack using curl Sorting and Renaming Specifying install user on Deb Ubu Supported DownloadClients Supported Indexers Supported Notifications Tips and Tricks Twitter Notifications Updating Webhook Schema Webhook
4 Updating
Taloth edited this page 2019-03-10 21:35:33 +01:00
Table of Contents

General

Branch - You can change the branch Sonarr will use to update, see Release Branches for more information.

Windows

Windows has automatic updates without making any changes.

Linux/OS X

Both Linux and OS X now have the ability to update directly from the UI or automatically, but it is not enabled by default.

Options

Automatic - Enable automatic updating, please test the update process manually to ensure it will work for your setup before enabling

Mechanism

  • Built-in - Use Sonarr's own updater
  • Script - Use a custom external script to update Sonarr, it will need to take care of stopping and starting Sonarr during the update process
  • Apt - Set by the Debian/Ubuntu package when updating is managed exclusively via Apt
  • Docker - Set by the Docker image author when updating is only allowed by using a new image version

Script - Visible only when Mechanism is set to Script - Path to update script

Update Process

Sonarr will download the update file, verify its integrity and extract it to a temporary location and call the chosen method. The update process will be be run under the same user that Sonarr is run under, it will need permissions to update the Sonarr files as well as stop/start Sonarr.

Built-in

The built-in method will backup Sonarr files and settings, stop Sonarr, update the installation and Start Sonarr, if your system will not handle the stopping of Sonarr and will attempt to restart it automatically it may be best to use a script instead. In the event of failure the previous version of Sonarr will be restarted.

Script

The script should handle the the same as the built-in updater, if you need to handle stopping and starting services (upstart/launchd/etc) you will need to do that here.

The script takes the following parameters:

  • {processId}: processid of currently running Sonarr instance
  • {updateSourceFolder}: folder containing new installation, ready to be moved to wherever you want it
  • {executingApp/monoPath}: path to mono/binary
  • {preservedArgumentsToRestartSonarr}: arguments to pass to the binary at restart

Getting Started

Troubleshooting

Additional Configuration

More Information

Development

API