Menu

Tree [bc9115] master 2.0.3.0 /
 History

HTTPS access


File Date Author Commit
 .github 2023-05-02 Henrik Johnson Henrik Johnson [bc9115] Improvement in backup tampering resilience
 bin 2022-04-18 Henrik Johnson Henrik Johnson [38ca6e] Significant new release inculing a lot of new f...
 docs 2023-03-17 Henrik Johnson Henrik Johnson [483a62] General stability and reliability enhancements
 gradle 2022-04-18 Henrik Johnson Henrik Johnson [38ca6e] Significant new release inculing a lot of new f...
 integrationtests 2023-04-28 Henrik Johnson Henrik Johnson [2e1887] Improved log integrity and other reliability en...
 linux 2022-10-27 Henrik Johnson Henrik Johnson [c1e326] Introducing partial safe sharing of backups. In...
 osx 2023-04-26 Henrik Johnson Henrik Johnson [8975a2] Stability and reliability improvements
 scripts 2023-03-08 Henrik Johnson Henrik Johnson [e018e3] Several fixes from the last release candidate. ...
 src 2023-05-02 Henrik Johnson Henrik Johnson [bc9115] Improvement in backup tampering resilience
 webui 2023-04-29 Henrik Johnson Henrik Johnson [28492e] Reliability and stability enhancements
 windows 2023-05-02 Henrik Johnson Henrik Johnson [bc9115] Improvement in backup tampering resilience
 .gitattributes 2022-05-31 Henrik (Mauritz) Johnson Henrik (Mauritz) Johnson [37649d] Added a new cypress based integration test of t...
 .gitignore 2023-02-15 Henrik Johnson Henrik Johnson [d94467] Companion service support added and many other ...
 LICENSE 2020-03-03 Henrik Johnson Henrik Johnson [a2f737] Initial public release
 README.md 2023-03-17 Henrik Johnson Henrik Johnson [483a62] General stability and reliability enhancements
 build.gradle 2023-05-02 Henrik Johnson Henrik Johnson [bc9115] Improvement in backup tampering resilience
 builddist.pl 2022-10-05 Henrik Johnson Henrik Johnson [5b7c87] Major improvements:
 gradle.properties 2022-04-18 Henrik Johnson Henrik Johnson [38ca6e] Significant new release inculing a lot of new f...
 gradlew 2020-03-03 Henrik Johnson Henrik Johnson [a2f737] Initial public release
 gradlew.bat 2020-03-03 Henrik Johnson Henrik Johnson [a2f737] Initial public release
 lombok.config 2020-03-03 Henrik Johnson Henrik Johnson [a2f737] Initial public release
 settings.gradle 2022-10-27 Henrik Johnson Henrik Johnson [c1e326] Introducing partial safe sharing of backups. In...

Read Me

Serverless backup solution with client side encryption with the following features.

  • Public-key based encryption allows continuously running backups that can only be read with a key not available on the
    server running the backup.

  • Ties into a free service that helps coordination of your backup sources, optional
    encryption key recovery, and coordination of sharing of backup data. However, all online services are optional, and
    you can run the backup software without an online account.

  • Provides optional paid-for storage service as part of the service offering.
    This is also entirely optional, and you can use any supported storage service you wish.

  • Pre-egress encryption means no proprietary data leaves your system in a format where it can be compromised as long as
    your private key is not compromised.

  • Allow selective sharing of backup data with other participants with complete cryptographically enforced security.

  • Designed from the ground up to manage very large backup sets with multiple TB of data and millions of files in a
    single repository.

  • Multi-platform support based on Java 17. Linux, Windows, and MacOS are officially supported but should run anywhere
    Java 17 is supported.

  • Low resource requirements, runs efficiently with 256MB of heap memory even if the backup sets have millions of files
    and terabytes of data.

  • Efficient storage of both large and small files with built-in deduplication of data.

  • Handles backing up large files with small changes in them efficiently.

  • Optional error correction to support unreliable storage destinations.

  • Encryption, error correction, and destination IO are plugin based and easily extendable.

  • Supports Dropbox, local file, Windows Shares, S3, Wasabi, Backblaze B2 and iDrive E2 for backup destinations.

  • Fully fledged web-based UI for both initial setup, monitoring and restore operations.

Getting Started

Download the binary or build it from the source

Download one of the releases and unpack it somewhere where it can be run.
On either Windows or MacOS you can simply run the installer and you will be prompted with
a web page for completing the setup. On these, systems the software will run as a user process
that automatically launches at log-in.

If running on Unix or Linux by default the software will run as a service owned by root.
Once installed can configure it by running the following command as root.

> underscorebackup configure

It should launch a web page that will guide you through the initial setup process. If you are running from a console
where it is not possible to launch a browser the first log entry should list the URL you need to go to interact with
the software manually.

Disaster has struck and my entire filesystem is gone. How do I restore it?

Start by installing Underscore Backup from scratch. Simply reinstall the application and in the setup point it to the
destination that you used for your repository metadata. The setup wizard will detect that an installation exists there
and
rebuild the local repository and allow you to start a restore of your files.

Using the command line

See separate doc for information about how to use the command line.

Configuration and files

See separate doc for information about the configuration files and how to use them.