Skip to main content

The ultimate Archlinux encryption USB dongiled setup.

Project description

donglify

The majority of Linux systems have a sever security threat. These installs are susceptable to data theft if the install disk is stolen. ArchLinux offers LUKS as an encryption method to protect the root & data partitions. Even then, the majority of these installs omit the encryption of the /boot or /efi partitions. This script helps automate the configuration of encrypted /boot. And provides a solution in replacement of the /efi partition, which usually can not be encrypted, by having it be present on a USB DONGLE.

Usage

To use donglify, you will need to install the initial configurations onto a USB, which can be done as follows:

donglify init /dev/sd[a,b,c]

This command creates the following partitions on your USB.

  • /efi, 512 MB, holds the EFI stub which the BIOS of a system to boot the USB.
  • /boot, 2GB, holds the kernels of the donglified systems, AND the dongle.ini configuration file.
  • dongleisos, size is set by the user, used to hold the ISOs which are available in the GRUB menu on USB boot, currently only loopback.cfg ISOs can be used.
  • donglepersist, size is set by the user, an encrypted LUKS partition that can be used by the user to store personal data.

In order to enter the interactive donglify prompt:

donglify /dev/sd[a,b,c][2]

The argument should be the donglified USB /boot partition.

Interactive Commands

donglify uses an interactive CLI interface to conduct its business. This is currently the only support, future support for automated installs could be added.

cmd: add

Adds host system configuration to the donglified USB. This configuration is automatically to the host system installed once established.

donglify> add

You will be prompted for configuration options.

You will need to add unlock root LUKS entry in /etc/crypttab.initramfs, otherwise the initial ramdisk won't ask to unlock your root partition on your added system. There you can also tell it about your keyfile location if you choose to do so.

[~] $ sudo cat /etc/crypttab.initramfs 
cryptssd UUID=<your UUID here> /boot/crypto_keyfile.bin
crypthdd UUID=<your UUID here> /boot/crypto_keyfile.bin

cmd: mount

donglify> mount

Mounts all donglified USB except for donglepersist.

cmd: unmount

donglify> unmount

Unmounts all partitions that mount mounted.

cmd: list

donglify> list

Lists all installed systems on the USB.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

donglify-20240124.tar.gz (1.1 MB view details)

Uploaded Source

Built Distribution

donglify-20240124-py3-none-any.whl (1.1 MB view details)

Uploaded Python 3

File details

Details for the file donglify-20240124.tar.gz.

File metadata

  • Download URL: donglify-20240124.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.18

File hashes

Hashes for donglify-20240124.tar.gz
Algorithm Hash digest
SHA256 f64798b006a22922a342300d2d90e4d7b476f1ed19081bb513844d93dfea1522
MD5 8d98f244fadc4b847d4ee48f0d018220
BLAKE2b-256 f1e82fd18e05fc1b9203f7bbc4aae1657b759b92c6773861c07d59feb2ad3dbd

See more details on using hashes here.

File details

Details for the file donglify-20240124-py3-none-any.whl.

File metadata

  • Download URL: donglify-20240124-py3-none-any.whl
  • Upload date:
  • Size: 1.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.18

File hashes

Hashes for donglify-20240124-py3-none-any.whl
Algorithm Hash digest
SHA256 b455e9373530bf556d79c9a2f0733fd21007236f4fcb7497c62dbd3c5efc7c53
MD5 3a6337f592d7f8d24052f0c7d9dfec14
BLAKE2b-256 22f7faa2e23618a6675746e447f65c8d495d8020d2278a2334383832e553219e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page