This wiki was built to describe TrueNAS CE Fangtooth 25.04.0
¶ Installation
¶ YouTube Basic Walkthrough
See the playlist here: https://youtube.com/playlist?list=PL6zQmF2gDqDT7SHyBe7ni1P2S4NzyJpD6&feature=shared
¶ Dashboard
¶ Storage
¶ Renaming a Pool
This is strongly recommended if you have a pool name with spaces or capitalization in it
If you have any apps or shares accessing the pool, stop them before starting these steps
- Navigate to Storage → Pool
- Click on the Export/Disconnect button to export the pool without destroying any of the data:
- Next, in the shell, run these commands as root:
zpool import original_name new_name
replacing the original name of the pool with the new name you have chosen.
zpool status new_name
to confirm the new name is working.
zpool export new_name
so we can import it in the GUI again.
- Lastly, navigate to the Storage → Pool tab and click the button for Import Pool in the top right corner. Select the new pool you have just renamed.
If you had any apps using hostpath for the old pool they will have to be edited/recreated. Same goes for rsync tasks, shares, snapshots, etc.
¶ Datsets
For snapshots and rollbacks at a granular level, datasets should be set up in the pool for each individual app.
¶ Host Path Config Storage
Apps running on Scale should use the Host Path Config option to store their data. You will find this option in the right hand menu under Storage Configuration > Type. This allows for the rapid redeployment of apps with no loss to their configurations, which can be considerable for some. Each app uses its respective host path from the example above. For a video explanation and example of this:
https://youtu.be/JZ9zbcyLcDo
¶ Permissions
In order for the apps to write to the dataset properly, make sure to select the ‘Apps’ option for the dataset preset:
Once the dataset has been created, you can still modify its permissions like below:
For a video walkthrough on permissions:
https://youtu.be/qAGN0_73cV4
¶ Shares
¶ Data Protection
¶ Network
¶ Adding a Static IP
Having a static IP to your server will prove necessary if you refer to your apps as IP:Port as shown in most of this wiki. If the IP of the server were to change, all of your apps would become unreachable.
- Navigate to Network > Interfaces
- Click the Pencil icon next to your ethernet adapter
- Uncheck the box for DHCP
- Click Add for the Aliases. Enter your IP address, then select /24.
Make sure the IP address you select is available
As long as you are accessing the WebGUI from the address you just selected, you should be given a prompt to Save Changes.
If you are coming from a different IP address, you will need to log back in within 60 seconds to the WebGUI at the new address you just chose, navigate to the Network page, then Save Changes.
¶ DNS Servers
We need to change the Nameservers away from our local to something more reliable.
- Navigate to Network > Global Configuration
- Click Settings
- Change Nameserver 1 to
1.1.1.1and Nameserver 2 to9.9.9.9.
¶ Building a Bridge
Before we setup the VM, we have to build a network bridge. This is necessary because without it, our VM won’t be able to see anything on our TrueNAS host. Follow the docs or even better, follow this YouTube video:
¶ Upgrading VMs From Previous Versions
Right now this is difficult to do with Windows but has been fairly straight forward with Linux. With Linux I notice the ethernet device changes upon migration, so if you are having issues use VNC to look at the console and troubleshoot your networking.
For Windows this migration guide should help. I didn’t write it, but it seems to work for many people.
¶ Incus Helper Scripts
Note that this repo is under development so not everything is functional!
Starting on Fangtooth, the ability to launch LXCs via the TrueNAS command line is now a thing. Similar to Proxmox, the creation of pre-built containers is vastly simplified by the use of scripts. See this website for a list of scripts available.
¶ Installing the CLI
In order to use the scripts you must first install the Helper Scripts CLI.
- Create a dataset for the CLI (unmodified general permissions will be fine)
- Navigate to the TrueNAS shell
- Enter these commands, assuming the path of the dataset is
/mnt/tank/scripts:
cd /mnt/tank/scripts
wget https://github.com/bketelsen/IncusScripts/releases/download/v0.1.3/scripts-cli_Linux_x86_64.tar.gz
tar -xzvf scripts-cli_Linux_x86_64.tar.gz
echo 'export PATH=$PATH:/mnt/tank/scripts' >> ~/.zshrc
source ~/.zshrc
echo 'export PATH=$PATH:/mnt/tank/scripts' >> ~/.bashrc
source ~/.bashrc
¶ Apps
Check out the new TrueNAS Apps directory and guide!
¶ Hardening
Lawrence does a great job of going over some basic security hardening tasks. Watch his video for some tips.
https://youtu.be/u0btB6IkkEk?feature=shared