Skip to content

rustic-rs/rustic_server

Repository files navigation

REST server for rustic

⚠️ This project is in early development and not yet ready for production use

We just merged a first refactor to axum and are working on the next steps.

There are a few things, we might still want to work on, namely:

  • checking what was going on with the typed routing

  • go through the tests and verify, that they are actually depicting the restic logic that we test our implementation against

  • check the ACL logic

  • improve the CLI

For now, expect bugs, breaking changes, and a lot of refactoring.

Please feel free to contribute to this project, we are happy to help you get started. Join our Discord and ask for help.

About

A REST server built in rust for use with rustic and restic.

Works pretty similar to rest-server. Most features are already implemented.

Contact

Contact Where?
Issue Tracker GitHub Issues
Discord Discord
Discussions GitHub Discussions

Are binaries available?

Yes, you can find them here.

Additional feature

Allows to give ACLs im TOML format, use option --acl

Example TOML file:

# default sets ACL for the repo without explicit path
# (and for the repo under path "default", if exists)
[default]
alex = "Read"
admin = "Modify"

[alex]
alex = "Modify"
bob = "Append"

Contributing

Tried rustic-server and not satisfied? Don't just walk away! You can help:

Do you know how to code or got an idea for an improvement? Don't keep it to yourself!

  • Contribute fixes or new features via a pull requests!

Please make sure, that you read the contribution guide.

Minimum Rust version policy

This crate's minimum supported rustc version is 1.70.0.

The current policy is that the minimum Rust version required to use this crate can be increased in minor version updates. For example, if crate 1.0 requires Rust 1.20.0, then crate 1.0.z for all values of z will also require Rust 1.20.0 or newer. However, crate 1.y for y > 0 may require a newer minimum version of Rust.

In general, this crate will be conservative with respect to the minimum supported version of Rust.

License

rustic-server is open-sourced software licensed under the GNU Affero General Public License v3.0 or later.