mirrors/rustic
2
0
Fork 0
mirror of https://github.com/rustic-rs/rustic.git synced 2025-10-26 11:18:51 +00:00
Code Issues Packages Projects Releases Wiki Activity
rustic - fast, encrypted, and deduplicated backups powered by Rust
1,364 Commits 24 Branches 37 Tags 24 MiB
Rust 99%
Just 0.4%
Smarty 0.4%
Dockerfile 0.2%
227974ca31
Go to file
renovate[bot] 227974ca31
chore(deps): update taiki-e/install-action digest to de0d48b (#894) 
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2023-09-17 02:45:29 +00:00
.cargo chore: remove git protocol flag for public-api as it's now working with sparse registry 2023-09-14 16:30:34 +02:00
.github chore(deps): update taiki-e/install-action digest to de0d48b (#894) 2023-09-17 02:45:29 +00:00
changelog feat(backup): Add init option (#805) 2023-09-11 06:17:27 +02:00
config feat(backup): Add init option (#805) 2023-09-11 06:17:27 +02:00
coverage Refactor to library and cli application part 2023-06-06 08:51:43 +02:00
crates style: cargo fmt & dprint fmt 2023-09-14 19:30:48 +02:00
docs chore: remove docs/screenshots directory as that has been moved to the assets repository 2023-09-12 02:20:22 +02:00
scripts Refactor to library and cli application part 2023-06-06 08:51:43 +02:00
src docs: fix item links in documentation for rustic_core 2023-09-14 19:27:10 +02:00
tests Move init command to rustic_core 2023-07-07 07:02:10 +02:00
util/systemd Systemd timers for backup and forget 2023-07-08 09:05:45 +02:00
xtask style: cargo fmt & dprint fmt 2023-09-14 19:30:48 +02:00
.gitignore chore: add temporarily generated files from tests to gitignore 2023-09-14 01:10:15 +02:00
build.sh build.sh: Add optional parameters 2022-11-30 13:31:34 +01:00
Cargo.lock ci: add cargo deny 2023-09-17 03:24:33 +02:00
Cargo.toml chore(deps): update rust crate toml to 0.8 (#890) 2023-09-15 03:24:19 +02:00
CONTRIBUTING.md docs: Update Readme layout, move docs to separate repository, add rustic_core Readme.md (#820) 2023-09-11 05:13:18 +02:00
deny.toml style: fmt 2023-09-17 03:27:01 +02:00
dprint.json ci: Replace dependabot with renovate for easier dependency management (#867) 2023-09-10 19:06:36 +02:00
LICENSE-APACHE Refactor to library and cli application part 2023-06-06 08:51:43 +02:00
LICENSE-MIT Refactor to library and cli application part 2023-06-06 08:51:43 +02:00
maskfile.md fix: maskfile 2023-09-14 01:47:17 +02:00
README.md Update header to point to assets repo 2023-09-12 02:19:32 +02:00

README.md

fast, encrypted, and deduplicated backups

About

rustic is a backup tool that provides fast, encrypted, deduplicated backups.

It reads and writes the restic repo format described in the design document and can be used as a restic replacement in most cases.

It is implemented in Rust, a performant, memory-efficient, and reliable cross-platform systems programming language.

Hence rustic supports all major operating systems (Linux, MacOs, *BSD), with Windows support still being experimental.

Stability

rustic currently is in beta state and misses regression tests. It is not recommended to use it for production backups, yet.

rustic Libraries

The rustic project is split into multiple crates:

Features

  • Backup data is deduplicated and encrypted.
  • Backup storage can be local or cloud storages, including cold storages.
  • Allows multiple clients to concurrently access a backup repository using lock-free operations.
  • Backups by default are append-only on the repository.
  • The operations are robustly designed and can be safely aborted and efficiently resumed.
  • Snapshot organization is possible by hostname, backup paths, label and tags. Also a rich set of metadata is saved with each snapshot.
  • Retention policies and cleaning of old backups can be highly customized.
  • Follow-up backups only process changed files, but still create a complete backup snapshot.
  • In-place restore only modifies files which are changed.
  • Uses config files for easy configuration of all every-day commands, see example config files.

Contact

You can ask questions in the Discussions or have a look at the FAQ.

Contact Where?
Issue Tracker GitHub Issues
Discord
Discussions GitHub Discussions

Getting started

Please check our documentation for more information on how to get started.

Installation

From binaries

cargo-binstall
cargo binstall rustic-rs

Windows

Scoop
scoop install rustic

Or you can check out the releases.

Nightly binaries are available here.

From source

Beware: This installs the latest development version, which might be unstable.

cargo install --git https://github.com/rustic-rs/rustic.git rustic-rs

crates.io

cargo install rustic-rs

Differences to restic?

We have collected some improvements of rustic over restic here.

Contributing

Contributions in form of issues or PRs are very welcome.

Please make sure, that you read the contribution guide.

Minimum Rust version policy

This crate's minimum supported rustc version is 1.67.1.

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

Licensed under either of:

at your option.