Subversion in OrionVM FreeBSD templates


When I first started building and maintaining the FreeBSD templates on the OrionVM cloud, I included a full ports tree extracted with portsnap, and I installed pkg. I figured this would give people a ready to use system more quickly out of the box, and would make initialising a system with tools like Ansible easier.

But it came with a couple of problems:

  1. Clients may only want a subset of the ports tree, or may want to use Subversion, or only use binary packages. In which case, my installing it at best wasted space.

  2. Binary packages may want to be sourced from quarterly or latest, depending on the target server and requirements.

This presented me with a poser. Our context system that live-injects SSH keys, IP addresses, and other user variables relied upon bash, because it was bootstrapped off our Linux templates. I spent part of my AsiaBSDCon 2019 WIP talk discussing how I’d rewritten all of this to use Bourne shell scripts, so no more needing to install bash from ports.

Which lead to the second point: did I still want to provide Subversion in the base image so people can use it to pull ports and sources in new VMs? The official FreeBSD Handbook lists installing Subversion as a discrete step before you can pull ports, but to do so I either needed a ports tree, or pkg. What to do?

I was checking the output from freebsd-update fetch, like a gentleman, and was reminded of something as an update line scrolled by:


That’s right, FreeBSD comes with a Subversion client. Somehow in this whole calculus I completely forgot about this. It’s also perfect for bootstrapping.

So now, without pkg, or a ports tree, one can download the latter:

# svn checkout /usr/ports
==> -sh: svn: not found

Haha whoops, wrong one:

# svnlite checkout /usr/ports
==> [...]
==> Checked out revision 498652

And because all the OrionVM FreeBSD templates use RootOnZFS with all the default options, there’s already a ZFS dataset for /usr/ports :).

The other option I’ve been considering is whether to ZFS snapshot any changes to stock FreeBSD, such that users could rollback or commit any changes I’ve done to the template after, such as including our context system. Then it wouldn’t matter what I added; you could always blow it away with a zfs destroy. I’ve give this some thought.

Author bio and support


Ruben Schade is a technical writer and IaaS engineer in Sydney, Australia who refers to himself in the third person in bios. Wait, not BIOS… my brain should be EFI by now.

The site is powered by Hugo, FreeBSD, and OpenZFS on OrionVM, everyone’s favourite cloud infrastructure provider.

If you found this post helpful or entertaining, you can shout me a coffee or buy some silly merch. Thanks!