Warning, /system/kup/README.md is written in an unsupported language. File is not indexed.

0001 # Kup Backup System #
0002 
0003 Kup is created for helping people to keep up-to-date backups of their personal files. Connecting a USB hard drive is the primary supported way to store files, but saving files to a server over a network connection is also possible for advanced users.
0004 
0005 When you plug in your external hard drive Kup will automatically start copying your latest changes, but of course it will only do so if you have been active on your computer for some number of hours since the last time you took a backup (and it can of course ask you first, before copying anything).
0006 In general Kup tries to not disturb you needlessly.
0007 
0008 There are two types of backup schemes supported, one which keeps the backup folder completely in sync with what you have on your computer, deleting from the backup any file that you have deleted on your computer etc. The other scheme also keeps older versions of your files in the backup folder. When using this, only the small parts of your files that has actually changed since last backup will be saved and therefore incremental backups are very cheap. This is especially useful if you are working on big files. At the same time it's as easy to access your files as if a complete backup was taken every time; every backup contains a complete version of your directories. Behind the scenes all the content that is actually the same is only stored once. To make this happen Kup runs the backup program "bup" in the background, look at https://github.com/bup/bup for more details.
0009 
0010 ## What the Kup backup system consists of ##
0011 - Configuration module, available in your system settings. Here you can configure backup plans, what to include, where to store the backup and how often. You can also see the status for the backup plans here.
0012 - A small program running in the background. It will monitor to see when your backup destination is available, schedule and run your backup plans.
0013 - Kioworker for accessing bup archives. This allows you to open files and folders directly from an archive, with any KDE application.
0014 - A file browsing application for bup archives, allowing you to locate the file you want to restore more easily than with the kioworker. It also helps you restore files or folders.
0015 
0016 ## Detailed list of features ##
0017 - backup types:
0018   - Synchronized folders with the use of "rsync".
0019   - Incremental backup archive with the use of "bup"
0020 - backup destinations:
0021   - local filesystem, monitored for availability. That means you can set a destination folder which only exist when perhaps a network shared drive is mounted and Kup will detect when it becomes available.
0022   - external storage, like usb hard drives. Also monitored for availability.
0023 - schedules:
0024   - manual only (triggered from system tray applet)
0025   - interval (suggests new backup after some time has passed since last backup)
0026   - usage based (suggests new backup after you have been active on your computer for some hours since last backup).
0027 
0028 ## Needed backup programs ##
0029 
0030 To actually create backups of your data you will need either "bup" or "rsync" installed. They
0031 provide the implementations for the two different types of backups that Kup supports.
0032 
0033 ## Compiling from source ##
0034 To compile you need:
0035 - CMake
0036 - extra-cmake-modules
0037 - The following libraries (including their development headers):
0038   - qt5-base
0039   - kcoreaddons
0040   - kdbusaddons
0041   - ki18n
0042   - kio
0043   - solid
0044   - kidletime
0045   - knotifications
0046   - kconfig
0047   - kjobwidgets
0048   - plasma-framework
0049   - libgit2
0050 
0051 Run from the source directory:
0052 ```
0053 mkdir build
0054 cd build
0055 cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=release ..
0056 make
0057 sudo make install
0058 ```