Skip to main content

A GUI for BorgBackup

Project description

Vorta - A Boring Open Source GUI for BorgBackup

Build Status

Vorta is an open source macOS/Linux GUI for BorgBackup. It's currently in beta status.

Main features

  • Encrypted, deduplicated and compressed backups using borg as battle-tested backend.
  • Works with any local or remote Borg repo. Try BorgBase for advanced features like append-only repositories and monitoring.
  • Repo keys are securely stored in macOS Keychain, SecretService or KWallet. Create SSH keys directly from the GUI.
  • Manage multiple backup profiles with different source folders, destinations and settings.
  • Flexible scheduling for automatic background backups. Only allow on certain WiFis.
  • Restore files from mounts or using the built-in backup browser.

Installation and Download

Vorta should work on all platforms that support Qt and Borg. Currently Borg doesn't support Windows, but this may change in the future. Setting allowed Wifi networks is currently not supported on Linux, but everything else should work.

macOS

Install the latest stable version via Homebrew Cask:

$ brew cask install vorta

Or directly download pre-built app bundles for macOS (10.13+) from Releases. For detailed setup steps, see the tutorial.

Linux

First install Borg using the package of your distribution or via PyPI. The latter needs some additional source packages. Then install Vorta from PyPI. Your local Python version should be >= 3.6. Python 2 is not supported.

$ pip3 install vorta

After installation run with the vorta command.

$ vorta

Debugging and Bugs

Please report any errors you may encounter by opening an issue on Github. Please include steps to reproduce and all logging output. Logs can be found in these folders:

  • Linux: $HOME/.cache/Vorta/log
  • macOS: $HOME/Library/Logs/Vorta

Development

Install in development/editable mode while in the repo:

$ pip install -e .

Then run as Python script:

$ vorta

Install developer packages we use (pytest, tox, pyinstaller):

pip install -r requirements.d/dev.txt

Qt Creator is used to edit views. Install from their site or using Homebrew and then open the .ui files in vorta/UI:

$ brew cask install qt-creator
$ brew install qt

To build a macOS app package:

  • add Sparkle.framework from here and borg from here in bin/macosx64
  • then uncomment or change the Apple signing profile to be used in Makefile
  • finally run to $ make Vorta.app to build the app into the dist folder.

Testing (work in progress)

Tests are in the folder /tests. Testing happens at the level of UI components. Calls to borg are mocked and can be replaced with some example json-output. To run tests:

$ pytest

Why the Name?

Vorta are a race referenced in Star Trek. They serve the Dominion and are replaced by their clones if they die. Just like our backups.

Privacy Policy

  • No personal data is ever stored or transmitted by this application.
  • During beta, crash reports are sent to Sentry to quickly find bugs. You can disable this by setting the env variable NO_SENTRY=1. Your repo password will be scrubbed before the test report is transmitted.

Author

(C) 2018 Manuel Riel for BorgBase.com

License and Credits

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vorta-0.6.1.tar.gz (132.1 kB view details)

Uploaded Source

File details

Details for the file vorta-0.6.1.tar.gz.

File metadata

  • Download URL: vorta-0.6.1.tar.gz
  • Upload date:
  • Size: 132.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1

File hashes

Hashes for vorta-0.6.1.tar.gz
Algorithm Hash digest
SHA256 0d7f2b22f61e5ec8efc7686aa840408d9a680eea11584c3e949e5fb7e6d61025
MD5 5b50ae9739cdf95f4877554cffbe9dc8
BLAKE2b-256 784bab7c27a6c4e47452824ef7ba248feeed59f7c3b6ed3772c9df043e0513fc

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page