Skip to content
encrypted file sender and receiver
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Postio is a encrypted file sender and receiver. Written in Rust Postio will encrypt a file (Using AES-256 in CBC mode) and send this file to an AWS S3. The initialization vector (IV) and symmetric key are also encrypted with RSA-4096 private/public keys. Your public key is sent to the AWS S3 store (different S3 instance) for the sender to get your public key to properly encrypt the file.

How to Install

You'll definitely need rust if you want to compile from source, also git.


  • Required packages
    • homebrew
    • openssl@1.1 (via homebrew)

CentOS (Fedora)

  • Required packages
    • gcc
    • zlib-devel
    • openssl-devel (version 1.0.2+ or if you want to use ChaCha version 1.1.0+)

Ubuntu (Debian)

  • Required packages
    • gcc
    • make
    • openssl (version 1.0.2+ or if you want to use ChaCha version 1.1.0+)
    • libssl-dev
    • zlib1g-dev (for zlib compression)

Finally install postio by cargo install postio

Next, you'll want to add your AWS key ID and secret access key in your environment. You can do this in unix by adding this to your .bashrc or .bash_profile and running source ~/.bashrcor source ~/.bash_profile or by adding these to the terminal you currently have open (limit control of these files, and make sure you do not accidently check them in to a git repository!):

export AWS_ACCESS_KEY_ID="your_key_id_here"
export AWS_SECRET_ACCESS_KEY="your_secret_access_here"

After that and you have a working binary you are good to go!


Postio 0.4.1
Ricky (Degausser) <>
Send and receive encrypted files

    Postio [FLAGS] [OPTIONS]

    -x, --setup        Create config file and populate settings
    -l, --list         List files in your queue
    -d, --no-delete    Do not delete files after getting them
    -a, --all          Get all files at once
    -Q, --clear        Deletes all files in your queue

    -g <number in queue>                  Gets file from queue
    -s </file/to/send>                    Send file to user
    -c, --config </path/to/config>        Sets a custom config file (defaults to $HOME/.postio/config)
        --encrypt <AES or ChaCha>         Set the encryption algorithm [default: AES]
    -o </path/to/output/directory>        Change output directory to something other than the current directory
    -u <>                   User to receive file

Config File Structure

Using serde postio will parse the config file in toml format.

The configure file should look like below:

email = ""
private_key = "/Users/rthosfelt/.postio/private_key.pem"
public_key = "/Users/rthosfelt/.postio/public_key.pem"
file_store = "postio"
file_store_region = "eu-west-2"
public_key_store = "postio-keys"
public_key_store_region = "eu-central-1"

On the first run the program will set up the config file for you (or you can ran postio -x to setup another config file, including generating the RSA private/public keys. You can also generate these on your own:

openssl genrsa -des3 -out private.pem 4096
openssl rsa -in private.pem -outform PEM -pubout -out public.pem


Feel free to put in a ticket for any issues in the code or to call me names.


IRC: degausser (freenode and Mozilla)

Software will remain free but be a good sport and buy me a beer/coffee BTC: 1HJL1PMXi7rgALSo5cPLnRxhdPLBQDjQhd

Licensing and Warnings

I take no responsibly for getting your files stolen/deleted/hacked/cracked/etc. Also please make sure you set up your AWS instance correctly or someone can run up the charges on your instance! Be smart, be secure!

Covered under the MIT license (C)

You can’t perform that action at this time.