User Tools

Site Tools


Turris CZ.NIC Omnia

The Turris Omnia is an open-source router from CZ.NIC. Stock firmware TurrisOS is based on OpenWrt and features Foris with assistants to aid in basic configuration and TurrisOS related settings and Luci for advanced configuration. It features a dual-core CPU, 1 or 2 GB RAM, 8 GB flash, 6 Gbit ports, SFP connector, USB 3.0, 3 mini PCIe slots populated with 2.4Ghz and 5Ghz wifi cards and much more.

Supported Versions

Experimental Versions

None at this time.

Hardware Highlights

ModelVersionSoCCPU MHzFlash MBRAM MBWLAN HardwareWLAN2.4WLAN5.0100M portsGbit portsModemUSB
OmniaMarvell Armada 385 88F682016008192NAND1024Qualcomm Atheros QCA986x/988x mini-PCIe, Qualcomm Atheros AR9287 miniPCIeb/g/na/n/ac-6-2x 3.0


Reset U-boot if needed

If the U-Boot environment has been modified previously (likely manually via serial console), first use serial to reset the default environment. Connect serial console and interrupt U-Boot. To do so you need to get to U-Boot prompt by hitting enter several times early after powering up till you see '⇒' prompt. Once you get there, enter the following commands:
env default -a

Note on OpenWrt

The original TurrisOS uses btrfs, standard OpenWrt only uses “normal” squasfs/jffs2 filesystem. This means that snapshots, rollbacks etc. do not work with OpenWrt.

Settings not saved after installation?

After following the installation steps below, you may encounter issues. The WiFi interfaces might not be shown via luci. Also, settings might be lost after a reboot. These issues can be solved by performing an upgrade via the web interface, to the same version, after the initial installation.

Method 1 - USB 'medkit' image without serial

  1. Copy openwrt-mvebu-turris-omnia-sysupgrade.img.gz and omnia-medkit-openwrt-mvebu-turris-omnia-initramfs.tar.gz to the root of a USB flash drive formatted with FAT32 / ext2/3/4 / btrfs / XFS. Note that the medkit MUST be named omnia-medkit*.tar.gz
  2. Disconnect other USB devices from the Omnia and connect the flash drive to either USB port.
  3. Power on the Omnia and hold down the rear reset button until 4 LEDs are illuminated, then release.
  4. Wait approximately 2 minutes for the Turris Omnia to flash itself with the temporary image, during which LEDs will change multiple times.
  5. Connect a computer to a LAN port of the Turris Omnia with a DHCP client
  6. (if necessary) ssh-keygen -R
  7. ssh root@; mount /dev/sda1 /mnt; sysupgrade /mnt/openwrt-mvebu-turris-omnia-sysupgrade.img.gz
  8. Wait another minute for the final OpenWrt image to be flashed. The Turris Omnia will reboot itself and you can remove the flash drive.

Method 2 - TFTP with serial

  1. Extract omnia-medkit-openwrt-mvebu-turris-omnia-initramfs.tar.gz and copy dtb + zImage to your TFTP server (rename if desired)
  2. Connect Turris Omnia WAN port to DHCP-enabled network with TFTP server
  3. Connect serial console and interrupt U-Boot. To do so you need to get to U-Boot prompt by hitting enter several times early after powering up till you see '⇒' prompt. Once you get there, enter the following commands:
  4. dhcp
  5. setenv serverip <tftp_server_ip_here>
  6. tftpboot 0x01000000 zImage
  7. tftpboot 0x02000000 dtb
  8. bootz 0x01000000 - 0x02000000
  9. OpenWrt will now boot from ramdisk, wait until yxou can connect to
  10. Download openwrt-mvebu-turris-omnia-sysupgrade.img.gz to /tmp/ (via scp, or wget if WAN connection is available)
  11. sysupgrade /tmp/openwrt-mvebu-turris-omnia-sysupgrade.img.gz
  12. Wait another minute for the final OpenWrt image to be flashed. The Turris Omnia will reboot itself.

Flash Layout

Layer0 NAND flash 8192 KiB
Layer1 mtd0 U-Boot 1024 KiB mtd1 Rescue system 7168 KiB

OEM easy installation

Download latest TurrisOS for Omnia from repo (see above). Save the file omnia-medkit-latest.tar.gz to USB flash to the root directory and put the USB flash to the front panel USB connector of the Turris Omnia router. The Turris Omnia router supports following filesystems: ext2/3/4, BtrFS, XFS and FAT. The Turris Omnia router has a reset button on its back panel. To enter re-flash mode press the reset button and wait for LEDs to indicate the number of the desired mode. Release the reset button when 4 LEDs light up. The Turris Omnia router will write the system image from the USB flash to the internal eMMC storage. During the course of the operation all LEDs are going to turn green. After a while the LEDs turn red. From this moment on the router must not be restarted or powered off. When the reflash operation is completed the router automatically restarts. Completion of the flashing process is indicated by turning all LEDs green for a moment during the boot. After that the LEDs transition to the standard operation indicator mode. When the process has completed you may remove the USB flash.

OEM installation using the TFTP method

Specific values needed for tftp

FIXME Enter values for “FILL-IN” below

Bootloader tftp server IPv4 address FILL-IN
Bootloader MAC address (special) FILL-IN
Firmware tftp image Latest OpenWrt release (NOTE: Name must contain “tftp”)
TFTP transfer window FILL-IN seconds
TFTP window start approximately FILL-IN seconds after power on
TFTP client required IP address FILL-IN

Upgrading OpenWrt

LuCI Web Upgrade Process

Terminal Upgrade Process

If you don't have a GUI (LuCI) available, you can alternatively upgrade via the command line. There are two command line methods for upgrading:

  • sysupgrade

Note: It is important that you put the firmware image into the ramdisk (/tmp) before you start flashing.


  • Login as root via SSH on, then enter the following commands:
cd /tmp
sysupgrade /tmp/



Factory reset mode 4 may help you. If that does not work, first reset uboot (using a serial connection).

Failsafe mode

Basic configuration

Basic configuration After flashing, proceed with this.
Set up your Internet connection, configure wireless, configure USB port, etc.

Specific Configuration

FIXME Please fill in real values for this device, then remove the EXAMPLEs

Network interfaces

The default network configuration is:

Interface Name Description Default configuration
vlan0 (eth0.0) EXAMPLE LAN ports (1 to 4) EXAMPLE None
vlan1 (eth0.1) EXAMPLE WAN port EXAMPLE DHCP

Switch Ports (for VLANs)

When setting VLAN on Turris Omnia, it is good to first have an understanding of the hardware setup and the interconnection of individual components. See the following schema:

The processor of the router Turris Omnia (SoC, Armada 385) has 3 network interfaces. In the system they are eth0, eth1 and eth2. Interface eth2 is connected directly to WAN/SFP on the back side of the router, the interfaces eth0 and eth1 are connected to the switch-chip, specifically to ports 5 and 6, and their assignment to the connectors LAN0 – LAN4 can be configured.

eth1 switch configuration is currently not supported in OpenWrt, only port 5 is the uplink to the switch. SFP is also not supported yet. See Forum post for progress. VLANs are also a problem on the LAN ports, see Forum post.

Numbers 0-4 are Ports 0-4 as labeled on the unit, 5 and 6 are the internal connection to the router itself. vlan0 = eth0.0, vlan1 = eth0.1 and so on.

Port Switch port
LAN 0 Port 0
LAN 1 Port 1
LAN 2 Port 2
LAN 3 Port 3
LAN 4 Port 4


hardware.button on howto use and configure the hardware button(s). Here, we merely name the buttons, so we can use them in the above Howto.

FIXME Please fill in real values for this device, then remove the EXAMPLEs

The Turris CZ.NIC Omnia has the following buttons:

EXAMPLE Reset reset
EXAMPLE Secure Easy Setup ses
EXAMPLE No buttons at all. -







Opening the case

Note: This will not void your warranty.

Remove 3 screws each from left and right side. Gently open the case, take care not to damage the thermally conductive pad that connects the case to the CPU for the passive cooling.

Main PCB:


port.serial general information about the serial port, serial port cable, etc.

How to connect to the Serial Port of this specific device:

Serial connection parameters
for Turris CZ.NIC Omnia
115200, 8N1


port.jtag general information about the JTAG port, JTAG cable, etc.

How to connect to the JTAG Port of this specific device:


port.gpio general information about GPIO

GPIO voltage is 3.3V, maximum current ±5mA.

When the electrical parameters are violated, proper function of ports is not guaranteed and the router can get damaged permanently!

GPIO pinout:


There is a patch available which integrates RGB LED support. It should be integrated into master soon. LED Patch

Bootloader mods

Hardware mods

Not directly a hardware mod, just a possibility for an addon: Turrisduino


OEM bootlog


OpenWrt bootlog




toh/turris_cz.nic/turris_cz.nic_omnia.txt · Last modified: 2019/01/04 01:40 by jamest42