> For the complete documentation index, see [llms.txt](https://docs.duplicati.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.duplicati.com/configuration-and-management/remote-sources.md).

# Remote sources

This page describes how to back up files from a remote location

{% hint style="info" %}
Remote sources can be added in the user interface from Duplicati 2.3.0.0.
{% endhint %}

Besides local files and folders, a backup can include files from a remote location, such as an SFTP server, an S3 bucket, or a cloud drive. Duplicati reads the files directly from the remote location during the backup, so they do not need to be copied to the local machine first.

Remote sources are also used for the [Microsoft 365](https://docs.duplicati.com/automation-and-integration/office-365-backup-and-restore.md), [Google Workspace](https://docs.duplicati.com/automation-and-integration/google-workspace-backup-and-restore.md) and [PostgreSQL](https://docs.duplicati.com/automation-and-integration/postgresql-backup-and-restore.md) backups.

## Supported remote sources

In Duplicati 2.4 the following [destinations](https://docs.duplicati.com/backup-destinations/destination-overview.md) can also be used as remote sources: File, SFTP (SSH), SMB, S3, IDrive e2, Box, Dropbox, Google Drive, and the Microsoft Graph based destinations (OneDrive, SharePoint, Microsoft Group).

## Lost connections and timeouts

From canary 2.4.1.100, a file read from a remote source is resumed if the connection is lost while reading. Duplicati reconnects, reads the file again up to where it stopped, and checks that this part did not change, before it continues. A file that the remote source cuts short is rejected with a warning and not stored, instead of being stored as if it was complete.

When the remote source is faster than the destination, reading is paused while a volume is uploaded. The timeouts only count the time spent waiting for the remote service, not these pauses, so a slow destination does not cause the remote source to time out.

## Adding a remote source in the UI

On the "Source Data" step of the backup setup, click "Add remote path". Pick the type of remote source and fill in the connection details as you would for a destination, then test the connection and click "Use remote source". The button is only enabled after the connection has been tested.

The remote source is shown in the source tree like a folder, and you can select and filter its contents like local files.

## Adding a remote source from the commandline

On the commandline, a remote source is given as a source path in the format `@<mount point>|<url>`:

```
duplicati-cli backup <destination url> "@/remote/server1|ssh://server1/data?auth-username=..." /home/user/documents
```

The mount point is a rooted path (such as `/remote/server1` or `C:\remote\server1`) that decides where the remote files appear in the backup. The files from the example above are stored as `/remote/server1/...`, and that is also the path you will see when [restoring](https://docs.duplicati.com/getting-started/restoring-files.md). The url is a regular destination url, including any options it needs.

The [SourceTool](https://docs.duplicati.com/duplicati-programs/command-line-interface-cli-1/sourcetool.md) can be used to check a remote source url before using it in a backup.

{% hint style="warning" %}
If a remote source cannot be reached during a backup, Duplicati logs a warning and completes the backup without the files from that source. If the source stays unreachable, retention rules can eventually delete the last version that still has its files. Keep an eye on warnings for backups with remote sources.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.duplicati.com/configuration-and-management/remote-sources.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
