Storage plugin⚓︎

Turris Omnia contains a soldered eMMC flash memory chip which is used as the system storage. It holds both the Turris OS itself and the created data. But if you want to use applications which need to save larger amounts of data you can use an external storage device.

The same applies to Turris 1.0 and 1.1 as well. Turris MOX (and Turris Shield) uses a microSD card instead, but it has properties very similar to the soldered flash memory.

The storage plugin allows you to easily move your /srv to an external drive. It both allows getting more space and lengthen the lifespan of the internal eMMC flash storage. The /srv directory is used for storing site-specific data as defined in the FHS specification. The storage plugin can’t move other parts of the file system. But it doesn’t matter because all data-intensive applications save their data into /srv.

First setup⚓︎

Pick an external storage device, which you want to move your persistent data to. It can be, for example, a simple USB flash drive, but it is strongly encouraged to use a regular HDD or SSD to get both higher speed and better durability.

In case of a USB drive, insert it into the USB slot on your router. If you are using a different type of storage, make sure that it is properly inserted or connected to the router.

Once the external storage is inserted, inside the Storage tab in reForis in the Prepare drives section, select where your persistent data should be stored and press the Format & Set button.

Once the external storage is inserted, inside the tab Storage in Foris, select where your persistent data should be stored and press the Format & Set button.

You will be asked if you are ready to continue. If you are ready, press OK. Now, for applying the changes, you need to reboot your system.

You can do this by going to the Notifications tab and pressing Reboot.

The reboot might take a long time because it involves the movement of your data to the new storage.

Once the process is finished, you have rebooted your router and logged back into Foris, the selected storage will be highlighted blue. This means that the operation was successful and your data will from now on be written to the external disk.

Multiple drives⚓︎

You can add additional drives anytime you need more space or redundancy. Simply select additional drive in the web interface.

Data on the newly selected drive will be deleted. Data on old drives will be spread across all enabled drives.

If you have more drives and want to remove/replace some of them, do so by unchecking them in in the Web UI and hitting Format & Set button. Removing drive takes a long time as data need to be moved out of it first and

Data redundancy⚓︎

By default, adding more drives will increase the capacity available in /srv. If you are using your router to store important data, you might want to set redundancy for your drives. This can be currently done only in CLI by calling the following commands:

uci set storage.srv.raid=raid1
uci commit storage

Then after hitting Format & Set button without changing any drives, raid level will be set and data rearranged.

Valid options are the following:

• raid1 – every piece of data is kept on two different drives (no matter how many drives you have), so if one drive fails, you can still get to your data
• single – there is only one copy of data – more space, but not redundancy
• custom – raid level is unchanged and only rebalance is done after adding/removing drive