Kasten

Kasten is a file hosting server that allows uploading, accessing and sharing of files with the browser. It is mainly written in Rust using Rocket.

The project also contains the tool bonbon, which allows for adding, listing and removing users.

Prerequisites

Kasten was written to run on GNU/Linux. While it may work on other systems, it was only tested on Arch Linux and Ubuntu 18.04.

You'll need the nightly version of rustc and Cargo to compile Kasten.

Installing Kasten

To build Kasten, follow these steps:

cargo build --release

To build bonbon, follow these steps:

cd bonbon
cargo build --release

You can compile both binaries by running the following command from the projects root:

cargo build --release --workspace

Using Kasten

To use Kasten, execute ./target/release/kasten. Rocket will accept requests at localhost:8000. Kasten supports the following environment variables:

• KASTEN_DB_LOCATION: The path at which the database is saved. (Defaults to ./var/server-sled-db)
• KASTEN_FILE_LOCATION: The path at which the uploaded files are saved. (Defaults to ./var/files)
• KASTEN_STATIC_FILES: The path at which the static files are saved. (Defaults to ./var/files)
• ROCKET_TEMPLATE_DIR: The path at which the templates are stored. (Defaults to ./vat/templates)

To use bonbon run ./target/release/bonbon [command]. To get a list of available commands run ./target/release/bonbon --help.

TODO

• File encryption
• Removing files/directories
• Logging

Contact

If you want to contact me you can reach me at paul.pumpernickel@posteo.eu.

License

This project uses the following license: GNU GPLv3.