Software & Update Management

Overview

openmediavault is a Debian based distribution. It uses APT to install packages. All standard Debian packages are upgraded using the official Debian mirrors. openmediavault packages are upgraded using the https://packages.openmediavault.org repository.

Update Management

Package updates will be displayed under System | Update Management | Updates in the web interface. There you can view the changelog of individual packages or install all packages at once.

The software cron-apt is used by openmediavault to perform a daily scheduled job to check for new package updates. Security updates will be installed automatically in the background. If you have notifications enabled you will receive an email every time packages are ready for installation.

Using CLI

omv-upgrade

This is non-interactive wrapper script that basically re-synchronizes the package index files from their sources and installs the newest versions of all packages currently installed on the system.

omv-release-upgrade

This is a script which is included only in the last versions of openmediavault before moving to the next major release version, e.g. 5.6.x to 6.x. This command migrates the system to the next major openmediavault version (which mostly includes a Debian distribution upgrade as well).

Installing plugins

Plugins can be installed via the web interface or CLI. If the plugin requires some extra software, the Debian package management will fetch all dependencies from the configured Debian package repositories.

Installing Software

You can install all software available in the Debian repositories on your server.

Warning

Please note that the installation of additional software may impair or prevent the functionality of openmediavault. This includes especially the installation of newer Python package versions via PIP which have already been installed via APT. Also, please do not install packages from Debian Backports, Testing or Experimental repositories, as this may install incompatible package versions. openmediavault is strictly tied to the Debian version it is based on.

Better use a container based solution to install additional software to do not affect the openmediavault operating system.

Warning

Do not install the apache webserver package, this leads to the uninstallation of the openmediavault package and the unusability of the system.

Install:

$ apt-get install <packagename>

Remove:

$ apt-get remove <packagename>

Purge (remove package and configuration files):

$ apt-get purge <packagename>

Repositories

Debian

The OS repositories are in this file /etc/apt/sources.list.

External

Debian provides the /etc/apt/sources.list.d/ folder for adding external repositories. The configuration files for the openmediavault package repositories are located here.

Warning

If there is a strong need to add the Backports, Testing or Experimental Debian repository just to install the most recent software, then please ensure that these packages are properly pinned [1] to avoid the system becoming unstable for adding core unsupported software by mistake.