Skip to main content

RunUp is a backup system that can be managed by command line.

Project description


GitHub Python version PyPI

RunUp is a backup solution that implements a new backup strategy: fragmented backups. This solution solves all the drawbacks of traditional strategies.

Fragmented backup

There are three typical backup strategies: Full backups, incremental backups and differential backups:

  • Full backups duplicate unmodified data and are very slow to create, but are easier and faster to restore.

  • Differential backups still create full backups (say weekly) and create partial backups containing only the new and modified files since the last full backup (say daily). This may reduce data duplication somewhat and makes partial backups faster than the full backup, but it makes restore slower because you need to restore the last full backup and the last differential backup.

  • Incremental backups work in the same way as differential backups but partial backups only contain the files changed since the last full or partial backup. This reduces data duplication even further and makes partial backups faster, but makes data restoration even slower, as you will have to restore the last full backup and all partial backups created after the full backup, in order.

With the above information in mind, I have come up with fragmented backups, a new backup strategy that only creates a full backup the first time, then all backups will be incremental backups. But the unchanged files are associated with the previously stored files, so during the backup restore, it is possible to "merge the fragments" and make the restore as fast as if it were a full backup.

Key features

Saves disk space

Files are never duplicated in the backup storage, even if they are duplicated in the repository or renamed without changing the content.

Create faster backups

Each backup contains only one copy of new or changed files. This allows us to create backups faster, saving time and memory usage.

Quick restoration of backups

When restoring data, we handle it as a full backup, so we don't have the inconvenience of tools that implement traditional partial backup strategies.


Install RunUp with PIP:

python3 -m pip install runup

Create a runup.yaml file with the configuration of your backups. This is an example to back up all files in the same directory as the configuration file:

version: '1'

      - '.'

Initialize RunUp.

runup init

Create a backup

runup backup

Restore the latest backup

runup restore

For details or more advanced options, see the documentation.


This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at


Contributions are welcome! See the Contributor's Guide.


This is a Free Open Source Software. If this project is of value to you, consider making a donation.

Donate me

Download files

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

Source Distributions

No source distribution files available for this release. See tutorial on generating distribution archives.

Built Distribution

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