Introduction

LUKS is one of the best disk encryption tools for Linux. We’ll see here how to use it.

Usage

Creating an Encrypted Partition

Be aware that if you use an existing partition, all its data will be erased when initializing the encrypted partition. To initialize it (sdb1 for example):

1
2
3
4
5
6
7
8
9

$ cryptsetup luksFormat /dev/sdb1 

WARNING!
========
This will overwrite data on /dev/sdb1 irrevocably.

Are you sure? (Type uppercase yes): YES
Enter LUKS passphrase: 
Verify passphrase:

Enter the password you want to use to decrypt the partition.

Unlocking

Next, we’ll unlock the encrypted partition to use it:

1
2

cryptsetup luksOpen /dev/sdb1 secret
Enter passphrase for /dev/sdb1:

‘secret’ corresponds here to the device mapper name. We can then verify its existence:

1
2

$ ls /dev/mapper/
control  secret

Preparing the Partition

Now we just need to format this partition:

1

mkfs.ext4 /dev/mapper/secret

And mount it in a directory.

Unmounting the Encrypted Disk

Once you’ve finished, you need to properly close the disk by unmounting and locking it:

1
2

umount /dev/mapper/secret
cryptsetup luksClose secret

Mounting the Encrypted Partition Permanently

If you want to mount the partition permanently, you’ll need to use fstab and crypttab. In crypttab:

1

secret /dev/sdb1 /root/password luks
  • secret: name of the device mapper
  • /dev/sdb1: the physical device
  • /root/password: the file containing your password (you can alternatively put the password directly in the crypttab file)

If you chose to use a file containing the key, create it like this:

1
2

cryptsetup luksAddKey /dev/sdb1 /root/password
chmod 600 /root/password

Then add the following line to fstab:

1
2
3

...
/dev/mapper/secret   /mnt   ext4   defaults   1 2
...

Your encrypted partition will now mount automatically at startup (there’s less benefit, but it might interest some users).

Adding a Passphrase

To add a passphrase (maximum of 8 total), here’s how to proceed. First locate your encrypted partition:

1

cryptsetup luksDump /dev/sdb1

Once you’re sure it’s the right one, add an additional passphrase:

1

cryptsetup luksAddKey /dev/sdb1

If you want to change a passphrase, you’ll need to delete the old one using the method mentioned below.

Removing a Passphrase

If you want to remove one of your passphrases:

1

cryptsetup luksRemoveKey /dev/sdb1
Edit this page

Last updated 23 Dec 2013, 21:16 +0200. history