Установка

Сборка в разработке

Опубликованный образ — ранняя сборка в разработке: возьмите его на странице «Скачать» или соберите сами из «исходников».

Требования

Не путайте с требованиями к сборке BSDnas — сборочной машине нужно сильно больше памяти и диска. Эта страница о работе системы.

• 64-битный процессор x86 (только amd64; образа под ARM нет)
• хотя бы один диск; отдельное загрузочное устройство не нужно

Отдельная флешка под систему не нужна

TrueNAS традиционно требует выделенное загрузочное устройство и запрещает держать пулы на нём. Обычно им становится флешка — и она умирает: это одна из самых частых бед домашних хранилищ.

У нас этого требования нет. Установщик умеет взять на каждом диске кусок заданного размера под систему, а остаток оставить под данные. Система живёт на зеркале из этих кусков, данные — в обычном пуле на остатках тех же дисков. Ни флешки, ни SATA-DOM, ни отдельного SSD.

Проверено на железе 2026-09-16: шесть дисков по терабайту, на каждом 16 ГБ под систему, boot-pool — зеркало из шести, пул данных — raidz2 из остатков. Зеркало из шести переживает отказ пяти дисков; в него намеренно включён диск с 432 нечитаемыми секторами — установка прошла, пул собрался.

Обычная установка на выделенный диск тоже работает, если так привычнее.

Память

Измерено, а не унаследовано из чьих-то рекомендаций:

RAM	результат
8 ГБ	грузится, доходит до READY; простаивающая система ест меньше 2 ГБ
4 ГБ	грузится, READY за 40 секунд
2 ГБ	грузится, READY за 40 секунд

Установщик предупреждает при памяти меньше 7 ГБ и продолжает; это предупреждение унаследовано от TrueNAS и не отражает того, что системе нужно для работы.

4 ГБ системе достаточно, чтобы загрузиться и работать. Это честный пол, и стоит понимать, на что на самом деле уходит остальная память:

• ZFS ARC — кэш чтения. ZFS занимает всю свободную память, и именно здесь лишние гигабайты превращаются в пропускную способность: машина с 4 ГБ работает, машина с 32 ГБ отдаёт те же файлы быстрее, потому что больше их лежит в RAM.
• Рабочие процессы — сессии SMB и NFS, джейлы, контейнеры, репликация и scrub берут память пропорционально тому, что вы реально запускаете.
• Дедупликация — если включите, ей нужно очень много RAM, и это вообще отдельный разговор.

Так что цифру планируйте от нагрузки, а не от требований загрузки. Числа в таблице измерены на простаивающей системе без пула под нагрузкой: они говорят, сколько нужно, чтобы стартовать, а не сколько — чтобы обслуживать.

Чистая установка

1. Запишите образ на USB-носитель или подключите как виртуальный привод.
2. Загрузитесь с него и выберите Install/Upgrade.
3. Выберите загрузочное устройство и подтвердите форматирование.
4. Задайте пароль root.
5. Выберите BIOS или UEFI — как загружается машина.
6. Извлеките носитель и загрузитесь с диска.

Дальше консоль показывает привычное меню с адресом веб-интерфейса. Входите как root с заданным паролем.

Виртуальные машины

Сборка работает под bhyve, KVM/QEMU и Proxmox. Учтите: гостевых дополнений VMware и Xen сейчас нет — эти порты не собираются на FreeBSD 15 текущим компилятором, — так что под этими гипервизорами вы теряете синхронизацию времени и корректное выключение со стороны гипервизора.

Для проброса дискового контроллера совет обычный: отдавайте виртуальной машине сам контроллер, а не виртуальные диски, нарезанные из датастора.

Проверка результата

# uname -a                      # должен сообщить 15.x-STABLE
# zpool status                  # пулы на месте и здоровы
# midclt call system.state      # должен напечатать "READY"

Ту же проверку проект поставляет как автоматическую приёмку — tools/acceptance.sh в сборочном репозитории устанавливает систему в виртуальную машину и проверяет результат через API. Именно им измерено каждое утверждение на этом сайте.