Duple Documentation and Tutorials

Duple offers two modes of configuration depending on your needs: Automatic and Advanced. The Advanced Mode lets you configure your private cloud manually, for better control over your data and infrastructure. If you prefer to let Duple do all the hard work, you can use the Automatic Mode.

Summary

How Does It Work?
Create a New Private Cloud
Connect to an Existing Private Cloud
Synchronization
Status
Duple Folder
Multiple Private Cloud
Collaborative Folder

How Does It Work?

Duple is a new kind of app that simplifies the concept of a private cloud. No more servers or complicated installation. One app, one storage, you're good to go!

The entirety of your private cloud is contained inside a single folder called a repository folder. This folder can be stored anywhere: USB hard drive, NAS, cloud file storage, etc... However in order to use your private cloud, Duple needs to be able to access your repository folder. That's why it is better to store it somewhere easily accessible from anywhere. You can't read the data contained inside the repository folder without using Duple.

On your devices (where Duple is installed), you get a second folder called Duple (inside your "User" folder). This folder contains the readable data, it's where you work with your private cloud: add, modify and remove your files there.

Your data is always at least in two places at the same time: inside the Duple Folder (present on every desktop device where Duple is installed) and in the repository folder.

Create a New Private Cloud

When you start Duple for the first time or use the Add Cloud menu (right click on the Duple logo near the clock) you will be presented with the setup assistant, choose Advanced Mode Configuration:

assistant

To create a new private cloud, select create. The app will only require one piece of information: where to store your repository folder. Right now Duple supports 3 types of connection: local, SFTP (SSH) and FTPS (FTP over TLS). The S3 protocol will be added soon.

storage

Local

To store your private cloud (repository folder) locally, select local. This mode is useful if you want to use a USB hard drive plugged directly to your computer as storage, or if your storage uses another protocol that Duple doesn't support (you can mount it locally and redirect the app to it).

local

Select where to store your repository folder and continue.

SFTP

To store your private cloud (repository folder) on a storage accessible via SFTP (SSH), select SFTP.

sftp

Fill the required SFTP's connection information and the path where to store the repository folder on the storage. You can choose to use a password or a public/private key (leave the fields that you don't need blank).

When connecting over SFTP, it is safer to use a public/private key pair instead of a password. Duple copies and stores locally the key pair in the configuration files. RSA, ECDSA and ED25519 keys (PEM and OpenSSH formats) are supported.

FTPS

To store your private cloud (repository folder) on a storage accessible via FTPS (FTP over TLS), select FTPS.

ftps

Fill the required FTPS's connection information and the path where to store the repository folder on the storage.

Certificates

To prevent MITM attacks, Duple remembers the storage certificate (for SFTP and FTPS) and will not connect to your private cloud if it changes. If you modify the storage certificate, you will need to reconnect to your cloud using the connect option.

final

That's it! You've created your private cloud! You can start adding files by moving them into the Duple folder (which has just been created inside your "User" folder). It contains the entirety of your private cloud.

Connect to an Existing Private Cloud

To connect to a private cloud, use the connect option of the Advanced Mode. You can access it via the Add Cloud menu (right click on the Duple logo near the clock) or when you start Duple for the first time, then choose Advanced Mode Configuration:

assistant

The rest of the process is exactly the same as Create a New Private Cloud.

Synchronization

Duple synchronizes the data inside your Duple Folder across all devices and with the repository folder. This happens when:

  • Duple starts
  • A modification is detected inside the Duple folder
  • Every hour

If you still want to force a synchronization, you can use the Synchronize menu (right click on the Duple logo near the clock).

The synchronization is always multi-directional. In case of conflict no data is overwritten or deleted, instead the conflicted file is renamed with a warning such as File (User's conflicted copy 2020-06-12). You will then have to decide which version to keep.

The technology has been designed to preserve the storage's lifespan. It will only query the storage when necessary, allowing it to fall into sleep mode as much as possible. Querying regularly your storage prevents it from going into sleep mode, and it also reduces its lifespan.

A P2P features is on its way to help protecting the storage's lifespan even more.

Status

You can check the synchronization status by looking at the Duple logo next to the clock:

status-1

Duple Folder

By default, when you create your first cloud the Duple Folder will be placed inside your "User" folder. It will be called Duple. It's where you work with your private cloud: add, modify and remove your files there.

If you add more than one cloud, you will be asked to choose where to place the other Duple Folder(s):

folder

Select an emplacement that suits you the best and continue with the process.

Multiple Private Cloud

You can create and connect to as many private clouds as you want. Just use the Add Cloud menu (right click on the Duple logo near the clock) and follow the instructions of Create a New Private Cloud or Connect to an Existing Private Cloud.

Collaborative Folder

A collaborative folder is a space where you can share your files with other people. We don't officially have sharing features, however the technology behind Duple is ready for it. We want to wait in order to get the user experience right.

Fortunately, you can already have collaborative folders by creating another private cloud and sharing the access to it with other people.