Skip to main content.

Full disk encryption in FreeBSD & OpenBSD


Live demo in BSD Now Episode 016 Originally written by TJ and Allan for | Last updated: 2014/02/20

Protecting your data is very important. You can have the tightest network security in the world, but if someone gets physical access, it's all worthless. This tutorial will show you how to set up an encrypted installation of FreeBSD or OpenBSD, step by step.

FreeBSD < 10.0

For versions of FreeBSD prior to 10.0, the encryption process was a very "manual" one. That being said, it's still not very difficult. Boot the installer and follow along as usual. Once you get to the partitioning menu, choose "shell." This will allow you to manually configure the disk encryption before the OS is installed. You can adjust the partition sizes or choose to do MBR instead of GPT if you prefer, but that's a bit more involved.

To view a list of disk devices, run:

# sysctl kern.disks

This tutorial assumes you are starting with a blank disk. If you're serious about data security, you’ll want to be sure to destroy any data already on the disk before starting. We'll be using the first SATA disk - /dev/ada0 - for our installation.

Write the partition table:

# gpart create -s gpt ada0

Create three partitions. The first is for the boot record, the second is an unencrypted /boot partition (from which the kernel is loaded) and the third is the large encrypted partition for the rest of the OS and files.

# gpart add -t freebsd-boot -s 512k -a 4k ada0
# gpart add -t freebsd-ufs -l bootfs -s 1g -a 1m ada0
# gpart add -t freebsd-ufs -l encrypted -a 1m ada0

Next we need to install the bootcode:

# gpart bootcode -b /boot/pmbr -p /boot/gptboot -i 1 ada0

Here's where we actually encrypt the partition. If you want to use different settings than the default provides, consult the geli manpage. You can adjust the number of rounds, key size, algorithm, HMAC, etc.

# geli init -b -s 4096 ada0p3

Enter passphrase:
Reenter passphrase: 

Use a very strong passphrase! Next we attach the device.

# geli attach ada0p3

Enter passphrase:
cryptosoft0: <software crypto> on motherboard
GEOM_ELI: Device ada0p3.eli created
GEOM_ELI: Encryption: AES-XTS 128
GEOM_ELI:     Crypto: software

Our new encrypted pseudo-device is /dev/ada0p3.eli. Now we can format the two partitions.

# newfs -U /dev/ada0p2
# newfs -U /dev/ada0p3.eli

Mount them and do a workaround for the unencrypted /boot.

# mount /dev/ada0p3.eli /mnt
# mkdir /mnt/unenc
# mount /dev/ada0p2 /mnt/unenc
# mkdir /mnt/unenc/boot 
# ln -s unenc/boot /mnt/boot

Next we must create the corresponding fstab for the system. The installer will write the fstab as part of the install.

# vi /tmp/bsdinstall_etc/fstab

In our example, it would look like this:

# Device        Mountpoint      FStype  Options      Dump    Pass#
/dev/ada0p2     /unenc          ufs     rw,noatime      1       1
/dev/ada0p3.eli /               ufs     rw,noatime      2       2

I added the "noatime" option for slightly better performance. You'll want to automatically load the kernel modules required for booting from an encrypted volume.

# vi /mnt/unenc/boot/loader.conf

Add the following:


If you have a CPU with AESNI, be sure it's enabled in your BIOS settings and add this line to improve performance:


Return to the installation.

# exit

It should continue as normal. Once it finishes, reboot and...

Enter passphrase for ada0p3:



As of version 5.3, booting from encrypted volumes on OpenBSD has been fairly simple. We'll be using 5.4 in this example. Boot from the install ISO and choose "Shell" at the initial prompt. Since I'm running the i386 version, the following is required before anything else:

# fdisk -iy wd0

This is assuming that wd0 is the drive you want to install to. Next up is creating a label for the disk. That can be done like so:

# disklabel -E wd0

I'll add a 1GB swap partition and use the rest of the disk for our root filesystem. Keep in mind the exact numbers you'll see will probably be different than the ones in my example. The string [in brackets] is the default, and you can overwrite it by typing something else. For swap, all you need to do is:

> a b
offset: [64]
size [10474316] 1g
Rounding size to cylinder (16065 sectors): 2104451
FS type: [swap]:

Now for the rest of the disk. You'll need to adjust the following if that's not what you want. Be sure to change the FS type to "RAID" when you do this step.

> a a
offset: [2104515]
size: [8369865] *
FS type: [4.2BSD] RAID
> w
> q
No label changes.

Now we encrypt the "a" partition of the drive using the bioctl command. Be sure to replace the drive and partition names if you aren't using what I used.

# bioctl -c C -l /dev/wd0a softraid0

New passphrase:
Re-type passphrase:
softraid0: CRYPTO volume attached as sd0

Our new pseudo-device for installation is sd0, so we can now exit the shell and go back to the installer

# exit

Press i for "Installation" and go through the process. It's pretty simple. The only thing you need to be aware of is that when it asks

Which disk is the root disk? ('?' for details) [wd0] sd0

You'll use the encrypted pseudo-device sd0 instead of wd0. Soon you should see:

Use (W)hole disk or (E)dit the MBR? [whole]
Use (A)uto layout, (E)dit auto layout, or create (C)ustom layout? [a] c

I like doing a custom layout here. It's very similar to what we did before.

> a a
offset: [64]
size: [6265286] *
FS type: [4.2BSD]
mount point: [none] /
Rounding size to bsize (32 sectors): 6265280
> w
> q

Install the sets you want. Once the install is complete, you should be prompted to reboot the system. Before doing so, let's enable enable the swap and make a couple performance-increasing changes.

# sed 's/rw/rw,softdep,noatime/g' /mnt/etc/fstab > /mnt/a
# mv /mnt/a /mnt/etc/fstab

Don't worry about encrypting the swap partition. OpenBSD has done that by default since 2005. And now, finally we can...

# reboot

And you'll be asked for your passphrase on startup.

Using drive 0, partition 3.
probing: pc0 apm pci mem[639K 254M a20=on]
disk: hd0+ sr0*
>> OpenBSD/i386 BOOT 3.21

That's it!

FreeBSD ≥ 10.0

In FreeBSD 10, the encryption process became a lot easier than it was before. Instead of manually encrypting the disk and copying your files over to it, an encryption option was built into the installer. The downside is that it's only for ZFS. If you want to use UFS, you have to do the same method as 9.X.

The only difference is instead of doing:

# vi /mnt/unenc/boot/loader.conf

You will need to add the modules to loader.conf during the partitioning step like so:

# vi /tmp/bsdinstall_boot/loader.conf

Otherwise it will be overwritten and fail to boot. To set up FDE with ZFS in FreeBSD 10.0 and later versions, simply choose "ZFS" at the "Partitioning" menu and toggle the "Encrypt disks?" prompt with the enter key.

The installation will continue as normal and prompt you for a passphrase to use. Once it reboots...

Enter passphrase for ada0p3:

So easy!

Latest News

EuroBSDCon 2014


As you might expect, both Allan and Kris will be at EuroBSDCon this year. They'll be busy hunting down various BSD developers and forcing them to do interviews, but don't hesitate to say hi if you're a listener!...

BSDCan 2014


We just wrapped up episode 35 after having some horrible audio issues. Sorry about the quality being lower than usual, we did the best we could given the circumstances. Next week we've got a normal episode, but the following week Allan and Kris will be at BSDCan. That week will...

AsiaBSDCon 2014


Both Allan and Kris will be going to AsiaBSDCon this year, so episode 28 will be shorter than usual. We'll be back the following week with a huge episode. Hopefully they can get some interviews there!...

Christmas & New Year


Episode 16 was just uploaded, and that's the last one we'll be doing live for this year. Episode 17 will be on Christmas, and feature a prerecorded interview with Scott Long about his BSD magic over at Netflix. Thanks for watching everyone! We look forward to more BSD Now in...

Episode 057: The Daemon's Apprentice


This episode was brought to you by Headlines NetBSD at Hiroshima Open Source Conference NetBSD developers are hard at work, putting NetBSD on everything they can find At a technology conference in Hiroshima, some developers brought their exotic machines to put on display As usual, there are lots of pictures and a nice report from...

Episode 056: Beastly Infrastructure


Direct Download: Video | HD Video | MP3 Audio | OGG Audio | Torrent This episode was brought to you by Interview - Peter Wemm - / @karinjiri The FreeBSD web cluster and infrastructure Feedback/Questions Todd writes in Brandon writes in All the tutorials are posted in their entirety at Send questions, comments, show ideas/topics, or stories...

Episode 055: The Promised WLAN


Direct Download: Video | HD Video | MP3 Audio | OGG Audio | Torrent This episode was brought to you by Headlines FreeBSD 10.1-BETA1 is out The first maintenance update in the 10.x series of FreeBSD is on its way Since we can't see a changelog yet, the 10-STABLE release notes offer a glimpse at some...

Episode 054: Luminary Environment


Direct Download: Video | HD Video | MP3 Audio | OGG Audio | Torrent This episode was brought to you by Headlines Portscout ported to OpenBSD Portscout is a popular utility used in the FreeBSD ports infrastructure It lets port maintainers know when there's a new version of the upstream software available by automatically checking the...