User Tools

Site Tools

This documentation applies only Turris OS 3.x that is no longer present in newly sold routers. The new documentation is located at

Installation and reinstallation of packages

Manual installation of packages might be needed when you're make a service to work on Turris Omnia. Reinstallation might be needed in case of technical problems.

Before installation

Before you install a package, please keep in mind the following:

  • Don't install everything just because you can. The more software is installed on the router, the greater is the chance of serious security problem occurring on your router. Every software has bugs, smaller or larger, and every one can be potentially discovered and misused by an attacker.
  • Pay attention when uninstalling a package and make sure that no other program needs it any more. Uninstalling a package might lead to a loss of key functionality of the router.

Once per 4 hours the versions of all installed packages are checked and if there is a newer version available, it is installed.

Through LuCI interface

Here we describe installation and reinstallation of packages through the LuCI interface. This option is recommended for less experienced users.


  • Open the section SystemSoftware.
  • Start by clicking the button Update lists. Then the list of available packages gets updated.
  • Switch to the tab Available packages.
  • Find the requested package on this page. You can either use the filer or or alphabetical list.
  • After finding the requested package, click Install to get it installed. The log in the upper part of the screen will inform you about the progress of the installation.


Unlike the command line program opkg, LuCI interface doesn't have a direct way to reinstall a package. To reinstall the package, you'll need to uninstall it first and then install it again.

  • Open the section SystemSoftware
  • In the tab Installed packages (which should be already opened) choose the package to remove / reinstall and click Remove .
  • Then install the package again according to this manual.

Through root terminal

Get access the command line with root privileges first. The instructions can be found here.


You'll be calling the opkg command in this section. It is good to know that by calling this command on Turris Omnia, you don't actually call the real opkg command directly. Instead, a script is run which calls the actual opkg and then adds the installed package to the list of packages to be updated. However, it makes no difference in most cases.

Update the list of available packages with command

opkg update

Then install the package by typing

opkg install name_of_the_package


Update the list of available packages with command

 opkg update 

Then reinstall the package by typing

 opkg install --force-reinstall name_of_the_package 

Option for more advanced users

The original opkg command only installs or removes the package. However, there's also the updater, which keeps the packages it knows about up to date (and removes any it thinks are not necessary). The wrapper script mentioned above also adds installed packages to /etc/updater/auto.lua, or removes them on removal.

There's a similar file, /etc/updater/user.lua, which is meant to be edited by the user. As an alternative mean, you may add the packages you want installed there and call ''', which would install them.