encrypted_fs

Crates.ioencrypted_fs
lib.rsencrypted_fs
version0.1.22
sourcesrc
created_at2024-04-12 21:26:19.157832
updated_at2024-04-21 11:31:31.808159
description[DEPRECATED] An encrypted file system that mounts with FUSE on Linux. It can be used to create encrypted directories.
homepage
repositoryhttps://github.com/radumarias/encryptedfs
max_upload_size
id1207102
size290,471
Radu Marias (radumarias)

documentation

https://docs.rs/encrypted_fs

README

EncryptedFS [DEPRECATED]

⚠️ Warning

Moved to encryptedfs. Please use that instead.

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 cloud storage like Google Drive, Dropbox, etc. and have it synced across multiple devices.


crates.io docs.rs

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 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
Commit count: 156

cargo fmt