README.md

Production-ready TUS protocol implementation written in Rust.

Features

This implementation has several features to make usage as simple as possible.

• Rustus is robust, since it uses asynchronous Rust;
• It can store information about uploads not only in files;
• You can define your own directory structure to organize your uploads;
• It has a lot of hooks options, and hooks can be combined;
• Highly configurable.

Please check out Documentation for more information about configuration and deploy.

Installation

You can install rustus by 3 different ways.

From source

To build it from source rust must be installed.

rustup update stable
git clone https://github.com/s3rius/rustus.git
cd rustus
cargo install --path .

Binaries

All precompiled binaries available on github releases page. You can download binaries from here, unpack it and run.

./rustus

Make sure that you download version for your cpu and os.

Using docker

One of the most simple ways to run rustus is docker.

Rustus has two containers for each version.

1. debian based image
2. alpine based image

Alpine based images are more lightweight than debian

To run rustus you just need to run this command

docker run --rm -p "1081:1081" -d s3rius/rustus --log-level "DEBUG"

To persist data you can mount volume to /data directory

docker run --rm -p "1081:1081" -d s3rius/rustus --log-level "DEBUG"