### Start Duplicati Server (GUI Package)

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/platform-specific-guides/using-duplicati-with-macos.md

When Duplicati is installed via the GUI package or Homebrew, its binaries are not in the system's PATH. Use the full path to invoke the server.

```shell
/Applications/Duplicati.app/Contents/MacOS/duplicati-server
```

--------------------------------

### Install Duplicati Windows Service (No Start)

Source: https://github.com/duplicati/documentation/blob/main/duplicati-programs/service.md

Use this command to register Duplicati as a Windows Service without starting it immediately after installation. This is useful if you want to manually start or configure the service before its first run.

```bash
Duplicati.WindowsService.exe INSTALL-ONLY
```

--------------------------------

### Example: Import Configuration with Duplicati.CommandLine.ConfigurationImporter.exe

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-other-commandline-utilities.md

This example demonstrates how to use the ConfigurationImporter.exe utility to import a backup configuration from a JSON file. Ensure the --server-datafolder path is absolute.

```bash
ConfigurationImporter.exe C:\backup-config.json --import-metadata=false --server-datafolder=<absolute path to folder that contains Duplicati-server.sqlite>
```

--------------------------------

### Install Mono on Ubuntu 12.04

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Installs Mono development tools on Ubuntu 12.04 (Precise). This procedure adds the Mono repository and installs the required packages.

```bash
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

echo "deb http://download.mono-project.com/repo/ubuntu precise main" | sudo tee /etc/apt/sources.list.d/mono-official.list

sudo apt-get update

sudo apt-get install mono-devel
```

--------------------------------

### Displaying Command Line Examples

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-using-duplicati-from-the-commandline.md

This command displays a set of examples demonstrating how to use the Duplicati Commandline tool for common operations. It's useful for understanding practical application.

```bash
Duplicati.CommandLine.exe help example
```

--------------------------------

### Install Duplicati Agent as systemd service

Source: https://context7.com/duplicati/documentation/llms.txt

Commands to install, enable, reload, and start the Duplicati Agent as a Linux systemd service. Also shows how to check its status.

```bash
sudo systemctl enable duplicati-agent.service
sudo systemctl daemon-reload
sudo systemctl start duplicati-agent.service
sudo systemctl status duplicati-agent.service
```

--------------------------------

### Example Output of Download and Decryption Process

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-disaster-recovery.md

This is an example of the output you might see when the `Duplicati.CommandLine.RecoveryTool.exe download` command is executed. It shows the progress of downloading and decrypting individual backup files. Note that errors, such as 'Invalid header marker', may indicate issues with the backup file or passphrase.

```text
Listing files on backend: ftp ...
Found 49 files
0: duplicati-20171109T100606Z.dlist.zip.aes - downloading (5.01 KB)... - decrypting ... done!
1: duplicati-20171109T100653Z.dlist.zip.aes - downloading (6.67 KB)... - decrypting ... done!
2: duplicati-20171109T100737Z.dlist.zip.aes - downloading (8.54 KB)... - decrypting ... done!
3: duplicati-20171109T100815Z.dlist.zip.aes - downloading (9.67 KB)... - decrypting ... done!
4: duplicati-b13a41763d40e4001911fd6f5d5d6c53d.dblock.zip.aes - downloading (1.67 MB)... - decrypting ... done!
5: duplicati-b2b06934c5d764025a6965f1749d86a90.dblock.zip.aes - downloading (9.93 MB)... - decrypting ... done!
6: duplicati-b2b4fb88d1edd4eccade6b0ea6fdbfcf3.dblock.zip.aes - downloading (10.00 MB)... - decrypting ... done!
7: duplicati-b34811487cc1843e289ac577b6a7a8533.dblock.zip.aes - downloading (9.94 MB)... - decrypting ... done!
8: duplicati-b385c55aa15bd403e9fcb5a321339e76a.dblock.zip.aes - downloading (9.95 MB)... - decrypting ... done!
9: duplicati-b4e0bcd6b8c0b4d648a97e53c32550cce.dblock.zip.aes - downloading (9.96 MB)... - decrypting ... done!
10: duplicati-b54b864868bf341bcb88bff9ad786b8a3.dblock.zip.aes - downloading (9.98 MB)... - decrypting ... done!
11: duplicati-b5f8cd40e22a54b5b988689370b8cde34.dblock.zip.aes - downloading (9.13 MB)... - decrypting ... error: 
System.IO.InvalidDataException: Invalid header marker
   at SharpAESCrypt.SharpAESCrypt.ReadEncryptionHeader(String password, Boolean skipFileSizeCheck)
   at SharpAESCrypt.SharpAESCrypt..ctor(String password, Stream stream, OperationMode mode, Boolean skipFileSizeCheck)
   at Duplicati.Library.Encryption.AESEncryption.Decrypt(Stream input)
   at Duplicati.Library.Encryption.EncryptionBase.Decrypt(Stream input, Stream output)
   at Duplicati.Library.Encryption.EncryptionBase.Decrypt(String inputfile, String outputfile)
```

--------------------------------

### Install Duplicati .deb Package (Linux)

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Installs the downloaded Duplicati .deb package using apt. Ensure the filename matches the downloaded file.

```bash
sudo apt install ./duplicati_[...]_all.deb -y
```

--------------------------------

### SyncTool Usage Example

Source: https://github.com/duplicati/documentation/blob/main/duplicati-programs/command-line-interface-cli-1/synctool.md

This is the basic command structure for using the SyncTool. Replace `<backend_src>` and `<backend_dst>` with your actual backend connection strings.

```bash
Duplicati.CommandLine.SyncTool <backend_src> <backend_dst> [options]
```

--------------------------------

### Start Agent with Registration URL

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/automation-and-integration/using-remote-management/using-remote-control-with-agent.md

Use this command to start the agent and register it with the Duplicati Console using a pre-authorized URL. Future invocations may not require the URL if the agent remains registered and the link is valid.

```sh
duplicati-agent --registration-url=<copied-url>
```

--------------------------------

### Start Duplicati Server Executable

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/platform-specific-guides/using-duplicati-with-windows.md

Invoke the Duplicati Server executable to start the service.

```powershell
C:\Program Files\Duplicati 2\Duplicati.Server.exe
```

--------------------------------

### Install Duplicati Windows Service with Options

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/platform-specific-guides/using-duplicati-with-windows.md

Install the Duplicati Windows Service and pass options such as the web service port and server data folder.

```powershell
C:\Program Files\Duplicati 2\Duplicati.WindowsService.exe INSTALL --webservice-port=8100 --server-datafolder=<path>
```

--------------------------------

### Install Mono on Ubuntu 14.04

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Installs Mono development tools on Ubuntu 14.04 (Trusty). This involves adding the Mono repository and installing the mono-devel package.

```bash
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

echo "deb http://download.mono-project.com/repo/ubuntu trusty main" | sudo tee /etc/apt/sources.list.d/mono-official.list

sudo apt-get update

sudo apt-get install mono-devel
```

--------------------------------

### Install Mono on Ubuntu 20.04/22.04/23.10

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Installs Mono development tools and libraries on Ubuntu systems. Ensure you have the correct repository and keys configured.

```bash
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

echo "deb https://download.mono-project.com/repo/ubuntu stable-focal main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list

sudo apt update

sudo apt install mono-devel gtk-sharp2 libappindicator0.1-cil libmono-2.0-1
```

--------------------------------

### Get Duplicati ServerUtil Help

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/platform-specific-guides/using-duplicati-with-linux.md

Command to display the help information for the Duplicati ServerUtil support program.

```bash
duplicati-server-util help
```

--------------------------------

### Install Mono using Homebrew

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Use this command to install the Mono runtime environment on macOS using the Homebrew package manager.

```bash
brew install mono
```

--------------------------------

### Custom JSON Output Template Example

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/monitoring-and-notifications/sending-reports-via-email/custom-message-content.md

This example demonstrates a template for JSON output, specifying which fields to include in the 'extra' element.

```text
%OPERATIONNAME% 
%backup-name% 
%machine-name% 
%PARSEDRESULT% 
%LOCALPATH%
%ENCRYPTION-MODULE%
%COMPRESSION-MODULE%
```

--------------------------------

### Getting General Help

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-using-duplicati-from-the-commandline.md

Use this command to access the general help documentation for the Duplicati Commandline tool. This provides an overview of available commands and usage.

```bash
Duplicati.CommandLine.exe help
```

--------------------------------

### Retention Policy Syntax Example

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/configuration-and-management/retention-settings.md

This example demonstrates the syntax for defining a retention policy using time formats to specify bucket sizes and contents. The 'U' value signifies unlimited backups within a bucket.

```text
7D:U,1Y:1W
```

--------------------------------

### Start Duplicati Server

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/platform-specific-guides/using-duplicati-with-linux.md

Invoke the Duplicati Server executable directly. When run as a regular user, it shares configuration with the TrayIcon.

```bash
duplicati-server
```

--------------------------------

### Basic Include/Exclude Filter Example

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/security-and-secrets/filters-in-duplicati.md

Demonstrates how filter order affects the inclusion and exclusion of files. Use include filters with '+' and exclude filters with '-'.

```text
+/usr/share/*.txt
-*.txt
-*.bin
+/usr/share/*.bin
```

--------------------------------

### Install Mono on Raspbian 8

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Installs Mono development tools on Raspbian 8. This procedure adds the Mono repository for Raspbian Jessie.

```bash
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

echo "deb http://download.mono-project.com/repo/debian raspbianjessie main" | sudo tee /etc/apt/sources.list.d/mono-official.list

sudo apt-get update

sudo apt-get install mono-devel
```

--------------------------------

### Run a Backup

Source: https://github.com/duplicati/documentation/blob/main/duplicati-programs/command-line-interface-cli-1/serverutil.md

Initiate a backup operation using its ID or name. The backup will be added to the queue and started once the queue is empty.

```bash
duplicati-server-util run <backup id or name>
```

--------------------------------

### Install Mono on Raspbian 9

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Installs Mono development tools on Raspbian 9. This command configures the Mono repository for Raspbian Stretch.

```bash
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

echo "deb http://download.mono-project.com/repo/debian raspbianstretch main" | sudo tee /etc/apt/sources.list.d/mono-official.list

sudo apt-get update

sudo apt-get install mono-devel
```

--------------------------------

### FTP Server Backup Files Example

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-disaster-recovery.md

This example lists the files found on an FTP server after four backup operations with a reduced upload volume size. It illustrates the typical .dblock, .dindex, and .dlist files generated by Duplicati.

```text
10,453,901  duplicati-b69a2a32a50bb4c6d8780389efdbf7442.dblock.zip.aes
     8,173  duplicati-i84de11dd9a334727a080a3cdedc11f76.dindex.zip.aes
10,409,309  duplicati-bb1e603b91cae420787ed855d40e7cc04.dblock.zip.aes
     9,677  duplicati-i77fdd0fa598d49fa93c5fedf3dbf4003.dindex.zip.aes
10,408,733  duplicati-b8fd38dcd303c4bcdb65dc15611f9b13b.dblock.zip.aes
     8,317  duplicati-id6042b5ed9c34faa86e41fd3bcff72d2.dindex.zip.aes
10,465,421  duplicati-bb1c167fdb8ef46e6a83fe1d5b8b33cbf.dblock.zip.aes
     6,765  duplicati-i1070213c1cea4844b3ace60c305854de.dindex.zip.aes
10,484,045  duplicati-b2b4fb88d1edd4eccade6b0ea6fdbfcf3.dblock.zip.aes
    11,341  duplicati-i0c85219ca5764fb183b4306e65ed2034.dindex.zip.aes
10,472,541  duplicati-bc70688944c1b4875b7561e8046dd582d.dblock.zip.aes
     8,301  duplicati-i726df1085487421b98bf9786e40d045f.dindex.zip.aes
10,384,701  duplicati-bf43697c750e746aead28ceb71af19359.dblock.zip.aes
     9,101  duplicati-ie084e3c9380847a8a01acefcb8245fe3.dindex.zip.aes
10,392,317  duplicati-bf797fdce00794d0dbeb31de1f3867240.dblock.zip.aes
     7,501  duplicati-i91b0156c9ced43bda26b6cef88f969b3.dindex.zip.aes
 1,754,637  duplicati-b13a41763d40e4001911fd6f5d5d6c53d.dblock.zip.aes
     3,709  duplicati-id79f5ccc6cb54f5faa7bbcf72c8e7428.dindex.zip.aes
     5,133  duplicati-20171109T100606Z.dlist.zip.aes
10,415,597  duplicati-bb4cb32561132426eba2e190089585362.dblock.zip.aes
     8,125  duplicati-ifd7c3d7bed47403197515b40821075fc.dindex.zip.aes
10,433,469  duplicati-b385c55aa15bd403e9fcb5a321339e76a.dblock.zip.aes
     6,909  duplicati-i59e5c4064b3d422995200772bd267645.dindex.zip.aes
10,447,373  duplicati-b4e0bcd6b8c0b4d648a97e53c32550cce.dblock.zip.aes
     8,829  duplicati-i21d3fcafc53b42bfa0dfe4cfdcc6a0d9.dindex.zip.aes
10,425,485  duplicati-b34811487cc1843e289ac577b6a7a8533.dblock.zip.aes
     8,093  duplicati-i92dcf425b2d14c8780c2938f84e2bc2c.dindex.zip.aes
 8,052,173  duplicati-bc385594379874159b0863dca12818ac7.dblock.zip.aes
     8,621  duplicati-ib02c8a76143440b99ec94773a7b00c90.dindex.zip.aes
     6,829  duplicati-20171109T100653Z.dlist.zip.aes
10,397,085  duplicati-b836b265755ff41ae908ef64e551ec63b.dblock.zip.aes
     8,717  duplicati-i0903704f50ec4277a0cb6e224bde49cb.dindex.zip.aes
10,404,509  duplicati-bc230fc2ccec54a33b2035fcbc0231ce4.dblock.zip.aes
     7,741  duplicati-i53b454d535de49e1983364b97bd681a1.dindex.zip.aes
10,463,597  duplicati-b54b864868bf341bcb88bff9ad786b8a3.dblock.zip.aes
     4,365  duplicati-id1e3d59e5e3e48f59a6fbd7f46b4bb8c.dindex.zip.aes
10,413,933  duplicati-b2b06934c5d764025a6965f1749d86a90.dblock.zip.aes
    11,421  duplicati-ifd2b08eaf75b43748739c5a140cb1267.dindex.zip.aes
10,468,957  duplicati-b5f8cd40e22a54b5b988689370b8cde34.dblock.zip.aes
     6,749  duplicati-ib9a135574fa84222beea313ac583463b.dindex.zip.aes
10,383,805  duplicati-bfa5ecd54953f455496a67b089e2ad35b.dblock.zip.aes
    10,301  duplicati-i19aa26f9c15e432ea5114c93acd52661.dindex.zip.aes
 4,505,165  duplicati-bd14cf57e975040808ac8d0f4bd9d5e36.dblock.zip.aes
     4,797  duplicati-id08a17cbe0a04407b4be37d2c48e8ab9.dindex.zip.aes
     8,749  duplicati-20171109T100737Z.dlist.zip.aes
10,483,357  duplicati-be6e935d55f0b443b8c716c83aebccb93.dblock.zip.aes
     9,885  duplicati-ic209185103c045bb87a680e98b78269b.dindex.zip.aes
   974,909  duplicati-b7fa18a6f863a42fea5f210cc5f1416e5.dblock.zip.aes
     2,125  duplicati-i57ce5109be6c4441998fc2bfb2cd0f3a.dindex.zip.aes
     9,901  duplicati-20171109T100815Z.dlist.zip.aes
```

--------------------------------

### Install Mono on Ubuntu 16.04

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Installs Mono development tools on Ubuntu 16.04 (Xenial). This procedure involves adding the Mono repository and updating the package list.

```bash
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

echo "deb http://download.mono-project.com/repo/ubuntu xenial main" | sudo tee /etc/apt/sources.list.d/mono-official.list

sudo apt-get update

sudo apt-get install mono-devel
```

--------------------------------

### Install Duplicati Windows Service

Source: https://github.com/duplicati/documentation/blob/main/duplicati-programs/service.md

Use this command to register Duplicati as a Windows Service. Arguments passed will be forwarded to the Server on startup. The service is configured to restart automatically.

```bash
Duplicati.WindowsService.exe INSTALL [arguments ...]
```

--------------------------------

### Enable and Start Duplicati Agent Systemd Service

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/platform-specific-guides/using-duplicati-with-linux.md

Commands to enable and start the Duplicati agent service, typically used when installing from a zip archive.

```bash
sudo systemctl enable duplicati-agent.service
sudo systemctl start duplicati-agent.service 
```

--------------------------------

### BackendTester Usage Example

Source: https://github.com/duplicati/documentation/blob/main/duplicati-programs/command-line-interface-cli-1/backendtester.md

Illustrates the basic command-line usage for the BackendTester tool, including the required protocol and authentication details for connecting to a storage backend. Supported backends are listed for reference.

```bash
Usage: <protocol>://<username>:<password>@<path>
Example: ftp://user:pass@server/folder

Supported backends: aliyunoss,aftp,azure,b2,box,cloudfiles,dropbox,ftp,file,gcs,googledrive,e2,jottacloud,mega,msgroup,onedrivev2,openstack,rclone,s3,ssh,od4b,mssp,sharepoint,sia,storj,tahoe,cos,webdav
```

--------------------------------

### Duplicati Event Script Example

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/automation-and-integration/scripts.md

This script handles Duplicati BEFORE and AFTER events for backup operations. It can modify dblock size before a backup starts and send an email notification after a backup completes. Ensure mail is configured on your system.

```bash
# file where result data is placed. This value cannot be changed by 
# writing it back!

# DUPLICATI__REMOTEURL
# This is the remote url for the target backend. This value can be changed by
# echoing --remoteurl = "new value".

# DUPLICATI__LOCALPATH
# This is the path to the folders being backed up or restored. This variable
# is empty operations  other than backup or restore. The local path can 
# contain : to separate multiple folders. This value can be changed by echoing
# --localpath = "new value".

# DUPLICATI__PARSED_RESULT
# This is a value indicating how well the operation was performed.
# It can take the values: Unknown, Success, Warning, Error, Fatal.



###############################################################################
# Example script
###############################################################################

# We read a few variables first.
EVENTNAME=$DUPLICATI__EVENTNAME
OPERATIONNAME=$DUPLICATI__OPERATIONNAME
REMOTEURL=$DUPLICATI__REMOTEURL
LOCALPATH=$DUPLICATI__LOCALPATH

# Basic setup, we use the same file for both before and after,
# so we need to figure out which event has happened
if [ "$EVENTNAME" == "BEFORE" ]
then
	# If the operation is a backup starting, 
	# then we check if the --dblock-size option is unset
	# or 50mb, and change it to 25mb, otherwise we 
	# leave it alone
	
	if [ "$OPERATIONNAME" == "Backup" ]
then
		if [ "$DUPLICATI__dblock_size" == "" ] || ["$DUPLICATI__dblock_size" == "50mb"]
		then
			# Write the option to stdout to change it
			echo "--dblock-size=25mb"
		else
			# We write this to stderr, and it will show up as a warning in the logfile
			echo "Not setting volumesize, it was already set to $DUPLICATI__dblock_size" >&2
		fi
	else
		# This will be ignored
		echo "Got operation \"OPERATIONNAME\", ignoring"	
	fi

elif [ "$EVENTNAME" == "AFTER" ]
then

	# If this is a finished backup, we send an email
	if [ "$OPERATIONNAME" == "Backup" ]
then

		# Basic email setup		
		EMAIL="admin@example.com"		
		SUBJECT="Duplicati backup"
		
		# We use a temp file to store the email body
		MESSAGE="/tmp/duplicati-mail.txt"
		echo "Duplicati finished a backup."> $MESSAGE
		echo "This is the result :" >> $MESSAGE
		echo "" >> $MESSAGE

		# We append the result of the operation to the email
		cat "$DUPLICATI__RESULTFILE" >> $MESSAGE

		# If the log-file is enabled, we append it
		if [ -f "$DUPLICATI__log_file" ]
then
			echo "The log file looks like this: " >> $MESSAGE
			cat "$DUPLICATI__log_file" >> $MESSAGE
		fi
		
		# If the backend-log-database file is enabled, we append that as well
		if [ -f "$DUPLICATI__backend_log_database" ]
then
			echo "The backend-log file looks like this: " >> $MESSAGE
			cat "$DUPLICATI__backend_log_database" >> $MESSAGE
		fi

		# Finally send the email using /bin/mail
		/bin/mail -s "$SUBJECT" "$EMAIL" < $MESSAGE
	else
		# This will be ignored
		echo "Got operation \"OPERATIONNAME\", ignoring"
	fi
else
	# This should never happen, but there may be new operations
	# in new version of Duplicati
	# We write this to stderr, and it will show up as a warning in the logfile
	echo "Got unknown event \"$EVENTNAME\", ignoring" >&2
fi

# We want the exit code to always report success.
# For scripts that can abort execution, use the option
# --run-script-before-required = <filename> when running Duplicati
exit 0

```

--------------------------------

### Install Mono on CentOS 6

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Installs Mono development tools on CentOS 6. This command adds the Mono repository and installs the mono-devel package.

```bash
yum install yum-utils

rpm --import "http://keyserver.ubuntu.com/pks/lookup?op=get&search=0x3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF"

yum-config-manager --add-repo http://download.mono-project.com/repo/centos6/

yum install mono-devel
```

--------------------------------

### Install Mono on Debian 9

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Installs Mono development tools on Debian 9 (Stretch). This involves adding the Mono repository and installing the mono-devel package.

```bash
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

echo "deb http://download.mono-project.com/repo/debian stretch main" | sudo tee /etc/apt/sources.list.d/mono-official.list

sudo apt-get update

sudo apt-get install mono-devel
```

--------------------------------

### List Duplicati CLI Help Topics

Source: https://github.com/duplicati/documentation/blob/main/duplicati-programs/command-line-interface-cli.md

Run this command to see a list of all available topics for help documentation within the Duplicati CLI.

```bash
See duplicati-cli help <topic> for more information.
  General: example, changelog
  Commands: backup, find, restore, delete, compact, test, compare, purge, vacuum
  Repair: repair, affected, list-broken-files, purge-broken-files
  Debug: debug, logging, create-report, test-filters, system-info, send-mail
  Targets: aliyunoss, azure, b2, box, cloudfiles, dropbox, ftp, aftp, file, gcs, googledrive, e2,
  jottacloud, mega, msgroup, onedrivev2, openstack, rclone, s3, ssh, od4b, mssp, sharepoint, sia,
  storj, tahoe, cos, webdav
  Modules: aes, gpg, zip, console-password-input, http-options, hyperv-options, mssql-options,
  runscript, sendhttp, sendxmpp, sendtelegram, sendmail
  Formats: date, time, size, decimal, encryption, compression
  Advanced: mail, advanced, returncodes, filter, filter-groups, <option>
  Secrets: secret, <provider>
```

--------------------------------

### Import Backup Configuration - duplicati-server-util

Source: https://context7.com/duplicati/documentation/llms.txt

Import a previously exported backup configuration file into the Duplicati server. Requires the file path and the encryption passphrase.

```bash
# Import a previously exported backup configuration
duplicati-server-util import ./home-docs-backup.json "export-secret"
```

--------------------------------

### Install Duplicati on RedHat-based Linux

Source: https://github.com/duplicati/documentation/blob/main/getting-started/installation.md

Use this command to install the Duplicati .rpm package on RedHat-based systems like Fedora or SUSE. This command installs all necessary dependencies.

```bash
sudo yum -i duplicati-version-arch.rpm
```

--------------------------------

### Aliyun OSS URL Format for Commandline

Source: https://github.com/duplicati/documentation/blob/main/backup-destinations/provider-specific-destinations/aliyun-oss-destination.md

Use this URL format to configure Aliyun OSS as a backup destination via the command line. Ensure the endpoint matches your bucket's region and obtain access keys from the Aliyun Cloud Console.

```text
aliyunoss://<prefix>
  ?oss-bucket=<Bucket name>
  &oss-endpoint=<Endpoint>
  &oss-access-key-id=<Access Key Id>
  &oos-access-key-secret=<Access Key Secret>
```

--------------------------------

### Install Duplicati on Debian-based Linux

Source: https://github.com/duplicati/documentation/blob/main/getting-started/installation.md

Use this command to install the Duplicati .deb package on Debian-based systems like Ubuntu or Mint. This command installs all necessary dependencies.

```bash
sudo dpkg -i duplicati-version-arch.deb
```

--------------------------------

### Install pyobjc for Tray Icon

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Install the pyobjc library using pip3 to enable the Duplicati tray icon functionality on macOS. This requires Python 3 to be installed.

```bash
sudo pip3 install pyobjc
```

--------------------------------

### Install Mono on CentOS 7

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Installs Mono development tools on CentOS 7. This involves enabling the Mono repository and installing the mono-devel package using yum.

```bash
yum install yum-utils

rpm --import "http://keyserver.ubuntu.com/pks/lookup?op=get&search=0x3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF"

yum-config-manager --add-repo http://download.mono-project.com/repo/centos7/

yum install mono-devel
```

--------------------------------

### Install Mono on Ubuntu 18.04

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Installs Mono development tools and libraries on Ubuntu 18.04 (Bionic). This command adds the Mono repository and installs necessary packages.

```bash
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

echo "deb https://download.mono-project.com/repo/ubuntu stable-bionic main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list

sudo apt update

sudo apt install mono-devel gtk-sharp2
```

--------------------------------

### Basic BackendTool Usage

Source: https://github.com/duplicati/documentation/blob/main/duplicati-programs/command-line-interface-cli-1/backendtool.md

Illustrates the fundamental command structure for the BackendTool, specifying the command, remote URL, and an optional filename.

```bash
duplicati-backend-tool <command> <remote url> [filename]
```

--------------------------------

### Environment Variable Conflict Resolution Example 1

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/configuration-and-management/preload-settings.md

Demonstrates how environment variables are merged. Settings from '*' are applied first, followed by specific configurations for 'tray', with later values overriding earlier ones for the same key.

```json
"env": {
  "*": {
    "E1": "a",
    "E2": "b"
  },
  "tray": {
    "E1": "c",
    "E3": "d"
  }
}
```

--------------------------------

### Install Duplicati Windows Service

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/platform-specific-guides/using-duplicati-with-windows.md

Use the bundled service tool to install the Duplicati Windows Service.

```powershell
C:\Program Files\Duplicati 2\Duplicati.WindowsService.exe INSTALL
```

--------------------------------

### Create Index with Duplicati Recovery Tool

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-disaster-recovery.md

Use this command to build an index of downloaded backup files. Specify the local folder containing the downloaded files. The index file will be created in the same directory by default. Use `--indexfile` to specify a custom location for the index file and `--tempdir` for temporary files.

```bash
Duplicati.CommandLine.RecoveryTool.exe index "C:\\BackendFiles"
```

--------------------------------

### Install Duplicati Dependencies (Linux)

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Installs necessary packages for Duplicati on Debian-based systems. Ensure you have apt-transport-https and other listed utilities.

```bash
sudo apt install apt-transport-https nano git-core software-properties-common dirmngr -y
```

--------------------------------

### Download Updated Duplicati Installer

Source: https://github.com/duplicati/documentation/blob/main/duplicati-programs/command-line-interface-cli-1/autoupdater.md

Use the download command to obtain an updated installer package for Duplicati. This feature determines the installed package type and downloads the latest available version. If it cannot determine the package or no update is available, it provides a URL for manual download.

```bash
duplicati-autoupdater download
```

--------------------------------

### Basic Backup Command

Source: https://github.com/duplicati/documentation/blob/main/duplicati-programs/command-line-interface-cli.md

Use this command to initiate a backup. Specify the remote URL and the source path. Multiple source paths can be provided. Passphrase is prompted if not supplied via --passphrase. Use --no-encryption for unencrypted backups.

```bash
duplicati-cli backup <remote url> <source path> [options]
```

--------------------------------

### Start Duplicati Agent

Source: https://context7.com/duplicati/documentation/llms.txt

Start the Duplicati Agent after it has been registered. Requires a settings encryption key and specifies the web service port.

```bash
duplicati-agent run \
  --settings-encryption-key="agent-db-key" \
  --webservice-port=8210
```

--------------------------------

### Run Backup with Pre/Post Scripts - duplicati-cli

Source: https://context7.com/duplicati/documentation/llms.txt

Use duplicati-cli to initiate a backup and attach custom scripts to run before or after the backup process. Specify scripts using --run-script-before-required or --run-script-after, and set a timeout with --run-script-timeout.

```bash
duplicati-cli backup "sftp://backup-server/backups" /data \
  --passphrase="secret" \
  --run-script-before-required=/etc/duplicati/pre-backup.sh \
  --run-script-after=/etc/duplicati/pre-backup.sh \
  --run-script-timeout=120s
```

--------------------------------

### Install Duplicati Agent as a Windows Service

Source: https://github.com/duplicati/documentation/blob/main/duplicati-programs/agent.md

Installs the Duplicati Agent as a Windows service. The registration link will be available in the Windows Event Log.

```powershell
Duplicati.WindowsService.exe INSTALL-AGENT <options>
```

--------------------------------

### Environment Variable Conflict Resolution Example 2

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/configuration-and-management/preload-settings.md

Illustrates a subsequent merge where new values from '*' and 'tray' are combined with existing settings. The final 'tray' configuration reflects the latest overrides.

```json
"env": {
  "*": {
    "E3": "f"
  },
  "tray": {
    "E1": "g"
  }
}
```

--------------------------------

### Local OAuth Server Command Line (Basic)

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/configuration-and-management/running-a-self-hosted-oauth-server.md

Run the OAuth server directly on a local machine without Docker. Configure listening URLs, hostname, storage, secrets, and services.

```bash
OAuthServer run 
  --listen-urls=http://localhost:8080 
  --hostname=localhost:8080
  --storage=file:///path/to/persisted/folder
  --secrets=/path/to/secrets.json.aes
  --secrets-passphrase=<encryption passphrase>
  --services=googledocs
```

--------------------------------

### Install Mono on Debian 10+

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-installation.md

Installs Mono development tools on Debian 10 and later. This command adds the Mono repository for stable versions.

```bash
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF

echo "deb http://download.mono-project.com/repo/debian stable-buster main" | sudo tee /etc/apt/sources.list.d/mono-official.list

sudo apt-get update

sudo apt-get install mono-devel
```

--------------------------------

### Start Duplicati TrayIcon

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/platform-specific-guides/using-duplicati-with-linux.md

Use this command to launch the Duplicati TrayIcon if it's not found in the program menu. It creates configuration files in the user's home directory.

```bash
duplicati
```

--------------------------------

### Custom Email Body Template Example

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/monitoring-and-notifications/sending-reports-via-email/custom-message-content.md

This example shows a custom template for the email body, utilizing various placeholders for backup operation details.

```text
Duplicati %OPERATIONNAME% for %backup-name% on %machine-name%

The %OPERATIONNAME% operation has completed with the result: %PARSEDRESULT%

Source folders: 
%LOCALPATH%

Encryption module: %ENCRYPTION-MODULE%
Compression module: %COMPRESSION-MODULE%

%RESULT%
```

--------------------------------

### File Destination URL Formats

Source: https://github.com/duplicati/documentation/blob/main/backup-destinations/standard-based-destinations/file-destination.md

Use the `file://` prefix for the file backend. For Windows, include drive letters and network shares. For Linux/MacOS, use standard file paths. The prefix clarifies intent but may be optional in some cases.

```bash
file://C:\Data
file://\\server\share\folder
```

```bash
file:///home/user
```

--------------------------------

### Secret Provider Values Example

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/security-and-secrets/using-the-secret-provider/README.md

Example of how secret provider might store values. These key-value pairs are used to resolve the placeholders used in the backup command.

```properties
s3-user=user
s3-pass=pass
passphrase=my-password
```

--------------------------------

### Duplicati Repair Command Example for B2 Storage

Source: https://github.com/duplicati/documentation/blob/main/community-docs/community-docs-using-duplicati-from-the-commandline.md

An example of using the repair command with B2 storage, specifying the storage URL, database path, and passphrase.

```bash
Duplicati.CommandLine.exe repair "b2://blacksmith/photos?auth-username=1234567890&auth-password=123ABc456dEfGH" --dbpath="C:\Users\User1\AppData\Local\Duplicati\SONSONSHE.sqlite" --passphrase="1234567890ABCdef"
```

--------------------------------

### Local OAuth Server Command Line (with TLS/SSL)

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/configuration-and-management/running-a-self-hosted-oauth-server.md

Run the OAuth server locally with TLS/SSL enabled. Specify certificate path and password for secure HTTPS connections.

```bash
OAuthServer run 
  --listen-urls=https://localhost:8080 
  --hostname=localhost:8080
  --storage=file:///path/to/persisted/folder
  --secrets=/path/to/secrets.json.aes
  --secrets-passphrase=<encryption passphrase>
  --services=googledocs
  --certificate-path=/path/to/certificate.pfx
  --certificate-password=<certificate password>
```

--------------------------------

### Initializing 'pass' with a GPG Key

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/security-and-secrets/using-the-secret-provider/local-providers.md

This command initializes the 'pass' password store using your GPG key. Replace '<your-email-address>' with the email associated with your GPG key.

```bash
pass init <your-email-address>
```

--------------------------------

### Include specific files and exclude others using filter order

Source: https://context7.com/duplicati/documentation/llms.txt

Demonstrates how filter order matters. This example includes all `.txt` files in `/home/user/docs` but excludes all other `.txt` files. Requires careful ordering of `--include` and `--exclude` options.

```bash
duplicati-cli backup "sftp://backup-server/backups" /home/user \
  --passphrase="secret" \
  --include=/home/user/docs/*.txt \
  --exclude=*.txt
```

--------------------------------

### Smart Retention Policy Example

Source: https://github.com/duplicati/documentation/blob/main/detailed-descriptions/configuration-and-management/retention-settings.md

This example shows the default 'Smart retention' policy available in the Duplicati UI. It defines a tiered retention strategy for recent backups.

```text
1W:1D,4W:1W,12M:1M
```