How to use the command `synoupgrade` (with examples)

The synoupgrade command is used to upgrade Synology DiskStation Manager (DSM), the operating system for Synology NAS devices. It provides several options for checking for upgrades, downloading and installing updates, and applying patches. In this article, we will illustrate each of these use cases with examples.

Use case 1: Check if upgrades are available

Code:

sudo synoupgrade --check

Motivation:

This command is useful when you want to manually check if there are any upgrades available for your Synology NAS. It allows you to verify if there are any new versions of DSM that can be installed.

Explanation:

• --check: This option is used to check for available upgrades.

Example output:

Checking for upgrades...
Upgrades are available.

Use case 2: Check for patches without upgrading the DSM version

Code:

sudo synoupgrade --check-smallupdate

Motivation:

If you only want to check for patches, without upgrading the DSM version, you can use this command. It is helpful when you want to ensure that your NAS is up to date with the latest patches.

Explanation:

• --check-smallupdate: This option is used to check for patches without upgrading the DSM version.

Example output:

Checking for patches...
Patches are available.

Use case 3: Download the latest upgrade available

Code:

sudo synoupgrade --download

Motivation:

When a new upgrade is available for DSM, you can use this command to download the latest upgrade package. It allows you to have the upgrade package ready for installation.

Explanation:

• --download: This option is used to download the latest upgrade available.

Example output:

Downloading DSM upgrade package...
Download complete.

Use case 4: Start the upgrade process

Code:

sudo synoupgrade --start

Motivation:

Once you have downloaded the upgrade package, you can start the upgrade process using this command. It initiates the installation of the new DSM version on your Synology NAS.

Explanation:

• --start: This option is used to start the upgrade process.

Example output:

Starting DSM upgrade...
Upgrade in progress.

Use case 5: Upgrade to the latest version automatically

Code:

sudo synoupgrade --auto

Motivation:

If you want to automate the upgrade process and upgrade to the latest version automatically, you can use this command. It saves you the effort of manually initiating the upgrade process.

Explanation:

• --auto: This option is used to upgrade to the latest version automatically.

Example output:

Automatic upgrade initiated...
Upgrade in progress.

Use case 6: Apply patches without upgrading the DSM version automatically

Code:

sudo synoupgrade --auto-smallupdate

Motivation:

If you want to automate the process of applying patches without upgrading the DSM version, this command can be used. It ensures that your NAS receives the latest patches automatically.

Explanation:

• --auto-smallupdate: This option is used to apply patches without upgrading the DSM version automatically.

Example output:

Automatic patch application initiated...
Applying patches...
Patch applied successfully.

Use case 7: Upgrade the DSM using a patch file

Code:

sudo synoupgrade --patch /path/to/file.pat

Motivation:

If you have a patch file for upgrading the DSM, you can use this command to apply the patch. It allows you to upgrade the DSM using the specified patch file.

Explanation:

• --patch: This option is used to specify the path to the patch file for upgrading the DSM.

Example output:

Applying patch from /path/to/file.pat...
Patch applied successfully.

Use case 8: Display help

Code:

synoupgrade

Motivation:

If you need help or want to get more information about the synoupgrade command, you can use this command to display the help menu. It provides information on the available options and how to use them.

Explanation:

Executing the command synoupgrade without any options displays the help menu.

Example output:

Upgrade Synology DiskStation Manager (DSM) - the Synology NAS operating system.
More information: <https://www.synology.com/dsm>.

Conclusion

The synoupgrade command provides various options for upgrading Synology DiskStation Manager (DSM) on Synology NAS devices. Whether you want to check for upgrades, download the latest upgrade, apply patches, or automate the upgrade process, this command has you covered. By understanding each of the use cases illustrated in this article, you will be able to easily upgrade your Synology NAS and keep it up to date with the latest features and security patches.