Last updated on 2019-10-16

Turris OS versions

Turris OS software is being released as a fixed set of packages for given version.

History of major Turris OS versions

Major Turris OS version OpenWrt version Released Support terminated Compatible routers
1.x.x 12.09 (Attitude Adjustment) ~1.2.2014 17.2.2015 Turris 1.x
2.x.x 14.07 (Barrier Breaker) 17.2.2015 24.5.2016 Turris 1.x
3.x.x 15.05 (Chaos Calmer) 24.5.2016 - Turris 1.x, Omnia
4.x.x 18.06 5.10.2019 - Turris 1.x, Omnia, Mox

For more detailed list of changes and versions history please see changelog.

How to find out version of Turris OS on your router

There are multiple ways how you can find out version of Turris OS running in your router. Few well advised ways are described here.

In Foris web interface

Navigate to router’s web interface (by default http://192.168.1.1). You should be greeted with list of web services running on router, please choose Foris. Next enter your password if requested. This brings you to Foris interface. In left menu column click on ABOUT and look for field Turris OS version.

Info

You might be greeted with first setup guide instead of list of web services. In such case you have to configure your router first. Please see appropriate First setup section in this documentation.

Foris About

In Luci web interface

Navigate to router’s web interface and choose Luci. Enter your password if required and you should be in Luci status page. Look for field Firmware Version in table with status of system.

Luci Status

Using SSH

You can connect to your router using SSH and view file /etc/os-release. The easiest option is to just simply print it to console with cat /etc/os-release.

Alternatively for script usage you can source /etc/os-release and use variable $(VERSION_ID}. Example follows:

. /etc/os-release
echo "${VERSION_ID}"

Versions of Turris OS provided from factory

When Turris routers are shipped from factory they are provided with stable version of Turris OS at that time. When you unpack new router or when you reset it to factory settings then it is running Turris OS of that exact version (unless medkit is used).

These versions have special form of support. For generic version there is limited window of time when update is guaranteed. Updates from old versions can possibly be problematic and Turris team can’t ensure compatibility with every single released version in past. The exception are factory versions. Updates from those should work and be tested in scope of base install (no additional packages).

Note

Although factory versions are supported and update path tested it might not be smooth simply because of possibly long update or problems during update Turris team can’t do anything about. For best experience it is advised to always reflash router from flash drive/SD card with latest version of Turris OS.

List of Turris OS factory versions

These are Turris OS versions flashed in factory and routers they were flashed to.

Turris OS version Used as factory for
1.0 Turris 1.0 1
2.1 Turris 1.1 1
3.2.1 Turris Omnia (CZ11NIC13)
3.8.3 Turris Omnia (CZ11NIC20)
3.8.5 Turris 1.0 and 1.1 after forced update 1
4.0-beta1 Turris Mox (early campaign SD cards)
4.0.0 Turris Mox (late campaign SD cards and early distribution)
4.0.1 Turris Mox (late 2019 distribution) and Turris Omnia (CZ11NIC23)

  1. Turris 1.x were originally sent out with Turris OS versions before 3.0 but because of DNS root key rollover there was a need to force update factory version in all of those routers. This happened with Turris OS 3.11. With this change Turris 1.x is considered to contain factory version Turris OS 3.8.5. Originally there was one more significant version of Turris OS for Turris 1.x and that was 3.7.3. This version was used to migrate from previous updater to updater-ng. With factory update to 3.8.5 it is no longer relevant.