TrueNAS Project

A person, who goes by @PapaGigas, has spent an appreciable amount of time defining and publishing a very thorough guide to setting up a TrueNAS server as a complete Home Server. It is good work, but as with all of these projects, is very tailored to his requirements and experience.

The original document is here: TrueNAS-Compose
He also has a discussion board here: Discussion Board

What I Do Like

It is very complete. It starts with setting up the TrueNAS server to be optimized to run Docker. His approach to setting up storage pools and propagating permission is good and works. After the initial configuration and installing the Dockge application which brings along Docker itself, he presents an organized approach to installing groups of applications. The progression is very logical. There are some applications that are necessary, or useful, in order to facilitate installing applications later in the process.

What I Don't Like

His approach is basically a one size fits all. He also assumes that the reader has never touched a TrueNAS system before. He describes each step in great detail even though he has been through it multiple times before. This isn't actually a bad thing but it does get tedious for the more experienced and actually frustrating for people who are are well versed in Linux operations even if they don't know TrueNAS in depth.

For example, while the instructions to open up the Dockge console is fine, once is sufficient. Subsequent times that the step is necessary it could be reduced to "Open the dockge console."

For as much depth as he goes into the minutia, there is no companion documentation about what happens under the covers. Networks ports are defined but extending the overall system is made difficult by some decisions that have been made.

He has a fascination with file systems. He defines file systems not just at the group level, which does make sense, but down to the container level. In some cases, there are multiple file system in play for a single application. This makes no sense to me. I will be flattening out the disk structure to one file system per group. As the members in the stack grow I will create additional stacks but share the original file system. For example, when the media stack becomes difficult to manage I will create a media2 stack bu it will continue to use the media file system.

There is a basic assumption that this system will be dropping into an empty environment. This isn't actually bad, but again someone choosing TrueNAS probably already has a well defined structure in place. The system may not be the only NAS in place. There may already be DNS/DHCP and reverse proxy solutions already in place.

There is no easy way to extend, or even modify, the configuration. The definitions for Pi-Hole and Traefik are literally cooked into final configuration. For Pi-Hole, this means that defining systems in the network outside of this system is quite difficult and time consuming. The way that he has implemented it locks down parts of the UI as a consequence.

While it is great for someone setting things up for the first time, if you already have a Cloudflare/Traefik/Pi-Hole solution that works, casting it aside is not really a option.

Several of the applications use either Maria or Postgres as data stores. There is a fair amount of duplication and overhead doing this. There are also not tools to work directly with the database engines directly. This is a pretty large hole.

Extensions and workarounds

The Environment

Applications created from the TrueNAS library, including dockge,

/mnt/tank/docker

In dockge, the stack and the environment are created as separate files. The contents on the .env section become a ls

Back to: Software on Linux Desktops