rel:: [[Databases MOC]] [[Operating Systems MOC]]
# TrueNAS
TrueNAS is the branding for a range of free and open-source network-attached storage operating systems produced by iXsystems, and based on [[FreeBSD]] and [[Linux]], using the [[OpenZFS|OpenZFS]] file system. It is licensed under the terms of the BSD License and runs on commodity x86-64 hardware.
## Reference
- [docs](https://www.truenas.com/docs/core/)
- [Source Code](https://github.com/truenas)
- [TrueNAS Forum](https://www.truenas.com/community/)
- [iXSystems JIRA](https://jira.ixsystems.com/ "https://jira.ixsystems.com/")
- [Popular Filters](https://jira.ixsystems.com/secure/ManageFilters.jspa?filterView=popular)
- [[Adaptive Replacement Cache|ARC]]
### Cheatsheet
#### Important Locations
| Place | Location | Notes |
| ------------------------------ | ----------------------------------------- | ------------------------------------------------ |
| Active System Config DB | `/data/freenas-v1.db` | [[SQLite]] db |
| System Dataset | `/var/db/system` | mount point for `<system dataset pool>/.system` |
| System Logs | `/var/db/system/syslog-*/log/*` | |
| Daily System Config DB Backups | `/var/db/system/configs-*/TrueNAS-*/*.db` | |
#### Restart ssh
TrueNAS doesn't use `/etc/rc.d` to manage ssh, so `service sshd restart` is not effective.
```bash
midclt call service.restart "ssh"
# or
killall -HUP sshd
```
Alternatively, configure `sshd` via GUI <https://truenas.local/ui/services/ssh>
#### Installing Debian VM
At the end of the installation
1. Power off the VM
1. Remove the CDROM device from the VM
1. Power on the VM
1. The EFI boot will fail (it is normal for Debian 10)
1. Wait 1 minute, that the EFI shell appears
1. Hit the key **Esc**
1. Exit the EFI shell
```
Shell > exit
```
Navigate in the menu of the EFI boot manager
- Boot Maintenance Manager
- Boot from file
- `<NO VOLUME LABEL ... GPT ...>`
- `<EFI>`
- `<debian>`
- `<grubx64.efi>`
Now GRUB appears and the system boots
Login as root and type the following commands to fix the EFI boot issue
```
mkdir -p /boot/efi/EFI/BOOT/
cp /boot/efi/EFI/debian/grubx64.efi /boot/efi/EFI/BOOT/bootx64.efi
```
### Scale
- [docs](https://www.truenas.com/docs/scale/)
- [truecharts](https://truecharts.org/)
- [helm template](https://github.com/truecharts/template)
## Builds
- [[NAS0]] for [[Balyeat House]]