Skip to content
Matt Simerson edited this page Oct 3, 2024 · 71 revisions

Install FreeBSD

If you haven't already, see the Introduction. System requirements are in the FAQ.

On the target host, install the latest version of FreeBSD from the image FreeBSD-13.N-RELEASE-amd64-disk1.iso, where N is the latest available version. During the install, select the appropriate keyboard map (usually default), and hostname. Disable all the optional installs and use an automatic ZFS-on-root file system. If you only have one disk, use the default stripe method. A mirrored pair of SSD disks are highly recommended. Enable boot time services ssh, ntpd, and powerd.

Set REQUIRED settings

Install the root TLS certificates (so HTTPS works) and download the mail-toaster.sh script, that bootstraps the installation.

sudo sh
pkg install -y ca_root_nss
fetch https://raw.githubusercontent.com/msimerson/Mail-Toaster-6/master/mail-toaster.sh

Run the script the first time. You will be prompted to set TOASTER_HOSTNAME and TOASTER_MAIL_DOMAIN. The settings will be saved to a mail-toaster.conf file. Do use valid hostnames and assure that forward and reverse DNS are set up correctly!

sh mail-toaster.sh

You can edit mail-toaster.conf and customize these other settings as well:

Setting Default Alternatives
JAIL_NET_PREFIX 172.16.15
JAIL_NET_INTERFACE lo1
JAIL_NET6 fd7a:e5cd:1fc1:HHHH:dead:beef:cafe
ZFS_VOL zroot
ZFS_JAIL_MNT /jails
ZFS_DATA_MNT /data
FBSD_MIRROR ftp://ftp.freebsd.org
TOASTER_MYSQL 1
TOASTER_NTPD ntpd openntpd, chrony, ntimed
TOASTER_NRPE 1
TOASTER_WEBMAIL_PROXY haproxy nginx

Prepare the Host

. mail-toaster.sh && provision host

Sample output.

Each install step will perform a bunch of actions and either end with an error or a proclamation of success. Do not continue until that step succeeds. If you get an error, open an Issue and be sure to include the console session output in the issue.

Continue to Base

Clone this wiki locally