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 - Kioslave 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 kioslave. 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 ```