Table of Contents
This documentation applies only Turris OS 3.x that is no longer present in newly sold routers. The new documentation is located at https://docs.turris.cz/.
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.
Installation
- Open the section System → Software.
- 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
Installto get it installed. The log in the upper part of the screen will inform you about the progress of the installation.
Reinstallation
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 System → Software
- 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.
Installation
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
Reinstallation
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 'updater.sh'', which would install them.
