README.md

---

Install FreeBSD accepting the default values. Choose either UFS or ZFS filesystem as your preference. No need to add a additional user. If you include kernel-dbg and lib32 make sure your partition is about 16G, otherwise 8G is sufficient.

In the manual configuration shell at the end of setup run the following.

Create the ZFS pool for obuilder (typicaly on a second disk)

zpool create obuilder /dev/da1

If your root rolume is UFS then you should explicitly import the ZFS volumes at boot with:

sysrc zfs_enable=YES

Add your SSH key, allow root to login and disable password authentication

mkdir -m 700 /root/.ssh
fetch https://github.com/mtelvers.keys -o /root/.ssh/authorized_keys
chmod 600 /root/.ssh/authoized_keys
sysrc -x sshd_flags
echo 'sshd_flags="-o ChallengeResponseAuthentication=no -o PermitRootLogin=yes -o PasswordAuthentication=no"' >> /etc/rc.conf

FreeBSD doesn't install Python by default so this must be installed before Ansible will work.

pkg install -y python

Finish the installation and reboot

exit

Ensure you can SSH to the machine (as root) without a password.

Add your new machine to the hosts file. Optionally specify the IP address if new_machine does not resolve in DNS.

new_machine ansible_host=1.2.3.4 capacity=10 zfs_dev=/dev/da1

Then create the base images on your FreeBSD machine:

ansible-playbook --limit new_machine playbook.yml

Once installed the worker logs to syslog and can be stopped and started with:

service worker start
service worker stop

Updating

Use update.yml to pause the worker, update it, rebuild the base images, and resume it.

ansible-playbook -i hosts update.yml

Manual partitioning

If you have a large single disk and need to partition it these commands may be helpful.

gpart add -t freebsd ada0
gpart show
zpool create obuilder /dev/ada0s2