This guide explains how to switch between different Deluge versions available on your service.
By default, your service uses the latest Deluge version. If you need to use an older version for compatibility with a specific plugin or workflow, you can easily switch to any version installed on the server.
Step 1 – List Available Versions
Log in to your service via SSH and run the following command to display all installed Deluge versions:
ls -ld /opt/deluge*
You should see output similar to the following:
/opt/deluge2.0.5 /opt/deluge2.1.1 /opt/deluge2.2.0
Step 2 – Switch to Another Version
To switch to a different version, copy its libraries to your local environment.
For example, to use Deluge 2.2.0:
mkdir -p ~/.local && cp -pr /opt/deluge2.2.0/lib ~/.local/
To switch to Deluge 2.0.5:
cp -pr /opt/deluge2.0.5/lib ~/.local/
To switch to Deluge 2.1.1:
cp -pr /opt/deluge2.1.1/lib ~/.local/
After copying the files, restart your Deluge instance from the Client Area.
Step 3 – Verify the Active Version
To verify which Deluge version is currently active, run:
deluge -v
Step 4 – Restore the Default Version
If you want to return to the default Deluge version provided by your service, remove the custom libraries with the following command:
rm -r ~/.local/lib/python3.10/site-packages/deluge*
Then restart Deluge from the Client Area.
Notes
- By default, your service always uses the latest available Deluge version.
- Switching versions can be useful if a plugin is only compatible with a specific Deluge release.
- Restart Deluge after changing or restoring the libraries so the selected version is loaded.
- Removing the custom libraries restores the default Deluge version.
