Skip to content

Latest commit

 

History

History
107 lines (82 loc) · 3.18 KB

README-template.md

File metadata and controls

107 lines (82 loc) · 3.18 KB

dups banner

Say Thanks Build status

Overview

dups is a simple backup utility using rsync for its heavy lifting while adding some convenience on top.

To reduce disk space and subsequent backup times, dups relies on rsyncs --link-dest option which hardlinks to existing unchanged files.

Motivation

Being unable to find a backup utility which would allow me to...

  • backup selected files and folders
  • exclude files and folders based on their path or patterns
  • easily access stored files without special tools
    (This includes the backup software itself)
  • doesn't come with to much bloat

...I ended up writing my own.
This is not to say other software is bad, just not what I was looking for.

Getting Started

See deployment for notes on how to deploy dups on a live system.

Prerequisites

Required system packages:

[[ req-sys ]]

Required python packages:

[[ req-py ]]

Installing

After all prerequisites have been met, dups can be installed with:

$ git clone https://github.com/linuxwhatelse/dups
$ cd dups
$ python setup.py install

System files for dbus, systemd etc. can be included by setting INCLUDE_DATA_FILES prior to running the installation.
This will require root access to copy the files to their respective location and is therefore ill-advised for live systems.
For live systems, see deployment instead.

$ export INCLUDE_DATA_FILES="systemd dbus desktop"
$ python setup.py install

For possible values see get_data_files in setup.py.

Build files/scripts for some distributions can be found in data/pkg/.

Usage

For a full setup guide and usage examples see the wiki.

As a quick overview, here's dups main help message.
Individual commands may have additional arguments.

[[ help ]]

Deployment

Packages for some distributions are automatically built and are available in the release section.

Additionally, the following distributions have a version accessible through their package-manager.

Distribution Link
archlinux aur - python-dups-git

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

  • tadly - Initial work - tadly

Credits

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details