Migration from Turris OS 3.x⚓︎
Update from Turris OS 3.x to 5.0 or newer is big leap. There is more than three years of significant development in OpenWrt. At the same time with this Turris team also took liberty to clean and rewrite some of theirs software. This means changes. Be prepared that some packages and features you are used to have might no longer be there.
Do not use configuration backups from Turris OS 3.x on newer versions. Configuration changed and using backup from Turris OS 3.x can make your router unacessible.
Short list of changes⚓︎
This is minimal list of changes you can expect with migration and switch away from Turris OS 3.x.
- API tokens are no longer available and mobile application no longer works.
- Server side backups were dropped. Replacement is not yet provided.
- uCollect was removed and replaced with Sentinel.
- Automation package list with Domoticz and Home-Assistant is no longer provided.
- Majordomo is no longer available as well as its package list. Use LuCI statistics or Pakon instead.
- Netutils package list was dropped and most of the advanced protocols have to be now installed manually.
- Print server Cups was dropped. Print server package list now provides only p910nd protocol.
- Sound card package list was dropped. Packages are still available and you have to install them manually.
- Squid proxy package list was dropped. Install
luci-app-squidas a replacement.
- Webcam package list was dropped.
- Network switch configuration now uses DSA. See the up to date documentation on how to configure VLANs.
Turris Omnia specifics⚓︎
- Turris OS 5.0+ no longer supports switching between SFP and metallic in runtime.
Switch is performed on boot for that boot-loader update is required. This is not
yet available and so you have to switch between SFP and metallic manually. To do
so you can run following command:
To switch to metallic you just have to use
ln -sf armada-385-turris-omnia-sfp.dtb /boot/dtb
sfpin this command. Initial switch is performed as part of migration so you have to care about this only if you plan to switch between SFP and metallic WAN.
Turris 1.x specifics⚓︎
- Significant change is switch from uClibc to Musl.
- Smrt support was removed.
Before you perform migration you should make sure to minimize possibility that it won’t finish.
- Make sure that you have at least 400MB of free space on root storage. This is just rule of thumb. It depends in reality on amount of installed software you have. It is possible that you need more or less than 400MB.
- Make sure that you have enough free RAM (memory). At minimum approximately 100MB. You can stop memory hungry containers and other services if need to be.
- Make sure that you have free time on your hands to let router perform migration.
- Create backup of your settings before you start not only to potentially recover it but also to provide it to support so Turris team can troubleshoot possible problems.
Do not attempt to upload backups created on Turris OS 3.x and before to Turris OS 4.0 and newer and vice versa. Network configuration changed and you are going to most likely cut yourself from access to router!
Considerations for advanced users:
- Backup packages you need from localrepo as they are going to be removed to prevent compatibility issues.
- If you have LXC container with more than one network interface then you have to do migration of such config on your own. It won’t be performed automatically. (This setup is not possible from LuCI)
It is always an option to perform factory reset to recover the router if migration fails. In case of Turris Omnia even rollback should be good enough.
Migration is not yet executed automatically but it can be triggered manually.
Do not attept to migrate Turris 1.x unless you are running on BTRFS with SD card. You are going to run out of storage space and factory reset would be the only option then.
To start migration you have to have at least Turris OS 3.11.19 installed on your
device. Please be sure about that before you attempt migration. To double check
you can run
pkgupdate from command line (over SSH). It should not ask you to
confirm any changes.
To initialize migration process you have to navigate to Updater tab in Foris web interface. There you have to select package list Migration to Turris OS 5.x and save that by clicking on Save and update button.
Next you have to approve installation of
tos3to4 package if you have approvals
enabled. Migration starts immediately if you don’t.
Migration takes some time. It can take up to hour or more. During that time router can become unaccessible. Do not reboot or disconnect router from power supply during that time.
Updates approvals are disabled once
tos3to4 package is installed to not halt
migration in situation when user is unable to approve subsequent continuation.
Update is finished once you receive notification that migration was finished. Message in question starts with with sentence: Migraton from Turris OS 3.x was completed..
On Turris 1.x before first reboot, after migration is completed, you have to
run following command over SSH:
/etc/updater/hook_postupdate/10_kernel-install. Failing to not do so can
result in to not-booting router.
Known problems and solutions⚓︎
You can encounter some problems that are caused by automatic migration. Not all problems can be automatically removed. These are known problems and solutions for them.
Updater reports error about unavailable package⚓︎
This happens because you had installed some package that is no longer available in Turris OS. This is intended as a protection of functionality you set up.
To recover updater functionality you have to decide what to do. You should go to
files in directory
/etc/updater/conf.d and check content of any file you created
as well as content of
/etc/updater/conf.d/opkg-auto.lua. You should remove any
You can verify updater’s functionality by running
I received message that Btrfs support was removed⚓︎
This affects only Turris 1.0 and Turris 1.1 routers.
This happens because name of package for Turris 1.x Btrfs support was changed. It
turris-btrfs and now is
turris1x-btrfs. Old package with
removal sends this message and it is removed because it is replaced by new one.
This is just false warning but just to be sure check that you have
turris1x-btrfs package installed in our system before reboot if you are running
from Btrfs microSD card.
Opkg can’t update repositories index after migration⚓︎
OpenWrt introduced a new concept for packages called “Alternatives”. The reason
for Opkg failure is that an appropriate alternative is not selected after
migration. This can affect also other tools but
wget is the most profound one.
Solution is to run
update_alternatives.sh command after migration completes.
Transmission and other services are disabled⚓︎
Some services, such as transmission, can be disabled during migration and not re-enabled. There are multiple reasons why this happens, in short it can be due to package or init script rename.
It is not possible to catch every single service affected by this so only most important services are covered by migration. Please review enabled services after migration to ensure that all services you want are going to be started on next boot.
Plans for automatic migration⚓︎
Automatic migration for all routers running Turris OS 3.x is planned.
There are still known problems with migration of Turris 1.x and it is also expected that this optional migration is going to discover some problems. Those have to be fixed before automatic migration is enabled.