#rev 2020-09-11 stroth
#rev 2019-08-23 schadavi

= Duplicati 2.0 (beta) =
[[https://www.duplicati.com|Duplicati]] is a free backup software to store encrypted backups online. It is available for Windows, macOS and Linux. Setup is identical on all operating systems.<<BR>>
''Duplicati'' is a frontend to [[http://duplicity.nongnu.org|duplicity]], for Linux the alternative [[https://wiki.gnome.org/Apps/DejaDup|DejaDup]] exists.


== Purpose ==
''Duplicati'' is the backup software of choice for '''personal backups''' on '''self-managed devices'''. Home and project directories are automatically backupped.


== Backup location ==
 * Before you start using ''Duplicati'', make sure you are able to access the [[Services/DataArchivingNG|lagoon archive]].
 * Map the network share `\\lagoon.ee.ethz.ch\archive\%USERNAME%\backup` with your backup directory persistently and save your login credentials. This is a requirement for automatic backups.
 . `%USERNAME%` is your ETH username, use your ETH login credentials to access the share.


== Installation ==
Download the installer for your operating system from [[https://www.duplicati.com/download|duplicati.com/download]]. Installers' names are similar to the following:
 * '''Windows''': `duplicati-2.0.5.110_canary_2020-08-10-x64.msi`
 * '''macOS''': `duplicati-2.0.5.110_canary_2020-08-10.dmg`
 * '''Debian/Ubuntu''': `duplicati_2.0.5.110-1_all.deb`
 * '''Red Hat/CentOS/SUSE''': `duplicati-2.0.5.110-2.0.5.110_canary_20200810.noarch.rpm`


=== First run setup ===
 1. Run the installer with default options
 1. Go through the first run setup when the internet browser opens and select ''yes'' for '''Multi-user environment'''


=== Settings ===
 1. '''Access to user interface''': Activate nothing
 1. '''Update channel''':  Select ''Default''
 1. '''Usage statistics''': Select ''None/disabled''


=== Add backup ===
==== Add a new backup ====
 1. Select ''Configure a new backup''

==== General backup settings ====
 1. '''Name''': Enter a name describing your backup, i.e. ''!EthUserProfile''
 1. '''Encryption''': If the backup is stored on ETH servers, select ''No encryption''

==== Backup destination ====
 1. '''Storage Type''': Select ''Local folder or drive''
 1. '''Folder path''': Enter `\\lagoon.ee.ethz.ch\archive\%USERNAME%\backup\Duplicati\%COMPUTERNAME%`
 . Replace `%USERNAME%` with your ETH user name
 . Replace `%COMPUTERNAME%` with the name of the computer you're using

==== Source data ====
 * Select ''Home'' and all other directories you want to backup
 
==== Schedule ====
 1. Check ''Automatically run backups''
 1. '''Next time''': Select a time you're computer is running, you're logged in and preferrably not working, like lunchtime.

==== General options ====
 * '''Remote volume size''': Set to at least ''1 GByte''
 * '''Backup retention''': Set to ''Keep all backups''

==== Advanced options ====
We recommend to activate the logging option.
 1. Open ''Add advanced option''
 1. Under ''Core options'' select the entry ''log-file''
 1. In the new field ''log-file'' enter `:\users\%USRNAME%\appdata\local\Duplicati\Duplicati-log.txt`
 . Replace `%USERNAME%` with your ETH user name


=== Restore from a backup ===
 * Select the '''Restore''' menu
 * Select the backup name you want to restore from and klick on '''Next'''.<<BR>>Do not use '''Direct restore from backup files...''' as this will not show shares you haven't connected to before starting the Duplicati2 Web gui.
 * Choose the backup set you want to restore from by its date in the pop-up menu '''Restore from'''
 * Select the directories/files you want to restore and klick on '''Continue'''
 * Select a destination for the restored files and klick on '''Restore'''

== Important notes ==
/!\ If you decided to select an encryption method and set a password, keep in mind your backups will be irretrievable if you loose this password!

/!\ Never delete your backup configuration after the first backup started running. Deletinc a configuration deletes the database keeping track of files in backup archives makes restoring files very difficult.
If you want to delete a backup configuration which contains backups, export it first!

----
CategoryBKUP