Duple Documentation and Tutorials

Summary

How Does It Work?
Serial Number
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.

Serial Number

Duple requires a serial number before you can start using the app (you can find it here). No, we don't miss the 90s! We sell privacy, so we don't like to store our user's login and password. For this reason, we use serial numbers. It's more private.

During the configuration of your first private cloud, you will be asked for it:

serial

Nothing complicated, enter your serial number, validate and continue the setup.

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:

assistant

To create a new private cloud, select create. The app will only require one information: where to store your repository folder. Right now Duple supports only 2 types of connection: local and SFTP. More protocols will be added in the future.

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, 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 blank the fields that you don't need).

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.

final

That's it! You've created your private cloud! You can start adding files by moving them into the Duple folder that's 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 setup assistant. 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:

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
  • another device notifies via P2P that an update is available

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 2019-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.

However the P2P network interconnecting the devices is not available yet (see missing features in bugs).

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.

Extra:
If you want to have the full user experience of a normal collaborative folder with Duple, and have everything under one folder, you can set the shared Duple Folder inside your private cloud's original Duple Folder.