#system #fuse #encryption #security

bin+lib encrypted_fs

An encrypted file system that mounts with FUSE on Linux. It can be used to create encrypted directories.

15 releases

new 0.1.22 Apr 21, 2024
0.1.21 Apr 20, 2024

#714 in Filesystem

Download history 679/week @ 2024-04-09 839/week @ 2024-04-16

1,518 downloads per month

Apache-2.0

160KB
3K SLoC

EncryptedFS

An encrypted file system that mounts with FUSE on Linux. It can be used to create encrypted directories.

It can then safely backup the encrypted folder on an untrusted server without worrying about the data being exposed.
You can also store it in any clound storage like Google Drive, Dropbox, etc. and have it synced across multiple devices.


encrypted_fs-bin crates.io docs.rs license

Usage

You can use it as a command line tool to mount an encrypted file system. or directly using the library to build your own binary (for library, you can follow the documentation).

Command Line Tool

Install from AUR

You can install the encrypted file system binary using the following command:

yay -Syu
yay -S encrypted_fs

Install with cargo

You can install the encrypted file system binary using the following command:

cargo install encrypted_fs

To use the encrypted file system, you need to have FUSE installed on your system. You can install it by running the following command (or based on your distribution):

sudo apt-get update
sudo apt-get -y install fuse3

A basic example of how to use the encrypted file system is shown below:

encrypted_fs --mount-point MOUNT_POINT --data-dir DATA_DIR

Where MOUNT_POINT is the directory where the encrypted file system will be mounted and DATA_DIR is the directory where the encrypted data will be stored.
It will prompt you to enter a password to encrypt/decrypt the data.

Change Password

The encryption key is stored in a file and encrypted with a key derived from the password. This offers the possibility to change the password without needing to decrypt and re-encrypt the whole data. This is done by decrypting the key with the old password and re-encrypting it with the new password.

To change the password, you can run the following command:

encrypted_fs --change-password --data-dir DATA_DIR

Where DATA_DIR is the directory where the encrypted data is stored.
It will prompt you to enter the old password and then the new password.

Encryption info

You can specify the encryption algorithm and derive key hash rounds adding these arguments to the command line:

--cipher CIPHER --derive-key-hash-rounds ROUNDS

Where CIPHER is the encryption algorithm and ROUNDS is the number of rounds to derive the key hash.
You can check the available ciphers with encrypted_fs --help.

Default values are ChaCha20 and 600_000 respectively.

Log level

You can specify the log level adding the --log-level argument to the command line. Possible values: TRACE, DEBUG, INFO (default), WARN, ERROR.

--log-level LEVEL

Dependencies

~12–26MB
~374K SLoC