🧠 Michael Cordell's Brain Dump

Search

SearchSearch

FreeNAS - TrueNAS

Aug 30, 20242 min read

FreeNAS is a FreeBSD based NAS appliance. TrueNAS is a renaming of the project and with the arrival of the SCALE project/version it is now based on Linux.

Replace a failing drive

  1. Note failing drive serial no / model: Storage → Disks → click on drive
  2. Offline the drive (Storage → Pools → Status (upper right corner)) → Triple dots → Offline
  3. Shutdown server, replace disk, power on
  4. Return to pool status screen, select the missing disk, triple dots, Replace
  5. Pool will resliver

SCALE

Applications

Since Core was FreeBSD based, and SCALE is linux based existing jails do not work. Replacing jails are “Applications” which is based on kubernetes. Applications themselves are Helm (the k8s package manager) charts, which are bundled packages for kubernetes. The TrueNas appliance provides a base set of charts, but a more comprehensive set is available at the community driven TrueCharts.

One area of confusion is PVC (persistent volume claim) which is the default for most TrueCharts charts. This is a kubernetes storage layer that is difficult to grok. You may elect to use HostPath instead when configuring a chart, which works as you may expect. If you need to look at the files in PVC, you will have to mount the pod’s PVC with truetool.

Connecting to applications

The canonical way to connect to apps is by clicking on the triple dots for the app and select “Shell”. This will launch a browser-embedded shell. If you want to connect over ssh, ssh into the appliance and as root run:

k3s kubectl get namespaces
k3s kubectl get -n <NAMESPACE> pods
k3s kubectl exec -n <NAMESPACE> --stdin --tty <POD> -- /bin/bash

Install truetool

truetool is a utility for work with SCALE.

sudo -i
cd /root
git clone https://github.com/truecharts/truetool.git

Migrating TrueCharts

HeavyBullets migration script can be used to upgrade containers through TrueCharts breaking changes.

Accessing Encrypted Cloud Syncs from TrueNAS

Link Aggregation on TrueNAS Scale with UniFi Switch

Assuming you already have a running TrueNAS on a single ethernet port, and have a second ethernet port with which to do link aggregation. Doc Page

Graph View

Backlinks