# Configure SendCrypt

# Creating your SendCrypt account

## Signing up from the SendCrypt Desktop Application

You can Sign Up for SendCrypt by clicking on the **Sign up** button on the top right of the SendCrypt Desktop Application.

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy82MzgzNTI3OC1iYjFiLTQ4YWQtYmY3OC02MjQwZjljMjliM2QvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDEyLjI4LjAwIDIucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTA4MjA5MDAsImV4cCI6MTc5MDkwNzMwMH0.NWbD-reAixlGwCocDrYWyhHjMUZjg-y_37-jpFvKiIA)

When you click on **Sign Up**, you will be redirected to the [SendCrypt website](https://sendcrypt.sib.swiss) to complete the registration.

## Signing up from the SendCrypt website

Once on the [SendCrypt website](https://sendcrypt.sib.swiss/register), you can sign up with your email address.


 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy8wZDAzNjVjYi1hNWQyLTQwYWMtYjM3NS0yZjdjNDkyNmZiY2MvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDEzLjMwLjA1LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.r0S82-h5daP0Fs5dnS5O_JaoHqpitzNabB4DTT8tSYA)Once you click on **Create account**, you will receive a verification email: ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy8yMWZlODk5MC1hZTNkLTQwOWItOGU4ZC1kOTFjMzI4MWM2ZDMvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDEzLjQwLjE3LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.uLv8qrXoHlbT8CyAzGsooybpQDsRqfHTr_vrjRdgZYA)

# Signing into SendCrypt

On the top bar of the SendCrypt application, click on **Sign in button.** ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy8xNTQwNzQ2Ny0yYzVjLTRkMWItYTQ0Mi1lMmEwMjZkNWMwMmEvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDEyLjI4LjAwIDIucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTA4MjA5MDAsImV4cCI6MTc5MDkwNzMwMH0.j8IA8Eqi24bT4ruJUjEAL9g1gDPWU0wyBQAO-dl0TyA)

Doing so will redirect you to the [SendCrypt login](https://sendcrypt.sib.swiss) page on your default browser. Finish signing in on your browser.

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy9hYjRmYjYwMC0yZGFkLTRmZDgtOTVkYi0zMzc1ZGU0NDllYzcvU2NyZWVuc2hvdCAyMDI0LTAyLTIxIGF0IDExLjU5LjIwLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.7Co_PZOrpW8V3ydOmYSVSEWQFe9p85TOXD3UAy4qavE " =385x522")After login, you will be prompted with the following dialog:

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy8wODBlNzIyZS1mMmIxLTRhNTYtYWQyZC1hMjEyNDRkN2E2MjkvU2NyZWVuc2hvdCAyMDI0LTAyLTIxIGF0IDExLjU5LjQ0LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.KYZG0UyysNo_JUHOdAVZT28LMWTeToqOO2Btiq3bdYw " =566x347")

Click on **Continue with browser** and then click on **Launch**. The browser will automatically ask you to reopen your SendCrypt Desktop Application and will activate your session.

In the top bar on the right side, you will see your email address which signifies that you are currently logged in.

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy9lYzNmM2I4Ni03YWU3LTRmNjctYjQwNi1kNTIzYThhZDU2OTAvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDEzLjQ1LjExLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.PJ3yZ_8WyssA1thJeSxN3oUtYtJnOyjQkEvTcofMqoI)

## My SendCrypt Desktop Application didn’t reopen successfully after clicking on **Launch**

In the case that clicking on the **Launch** button didn’t prompt your browser to open the SendCrypt Desktop Application, you can manually copy your session token from the website, by clicking on **Manually enter token**:

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy9hOTk0ZTAxNS00MTcwLTQwYzgtODIzMy1hYjY4MTMzZTA5MGQvU2NyZWVuc2hvdCAyMDI0LTAyLTIxIGF0IDEyLjAzLjQ2LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.iYzKEAl1MzsKb6y7GYsS-6NPdlPd_I-FhW9JkpIbU7A " =531x324")

Then, paste the token into your application:

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy80ZGMyZmNlNC1hNjZmLTQzMTktOWE5Yy01MDE5ZjQ0YzlhNDIvU2NyZWVuc2hvdCAyMDI0LTAyLTIxIGF0IDEyLjA0LjMwLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.8xYTPao74HXCL1yx3ImUrRt0MjvQEkAdUZLrwbRa4ts " =912x712")

# Configure your SSH access

SendCrypt relies on the **SFTP** protocol to transmit data. Therefore, it requires some configuration to ensure that it will use a valid pair of **SSH keys** to connect to the remote server.

In the SendCrypt Desktop Application, click on **Settings** in the left panel to access the settings of the application.

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy8yZTI4MDdjNy1mZGJiLTRhOWEtYTgxYS02ZTNhZGI1ZWZlMzYvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDEzLjQ4LjQyLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.ZKIWZe4WNpz84JyoF4-jQcgfGmFXxPhMbyBV1wzg1ro)

Scroll down until you see the **SSH** section. By default, SendCrypt will automatically assume that you have **ssh** installed on your machine. It will therefore, automatically try to select `/Users/{user}/.ssh/id_rsa`and `/Users/{user}/.ssh/id_rsa.pub` as your SSH keys. If that’s correct you can skip the following part.

If you already use a pair of SSH keys, simply click on **Browse** to open a dialog that will allow you to select your SSH keys.


:::info
If your SSH private key is protected with a password, you can use the field **Passphrase** to fill your password and then click on **Save** to save it. Please note that your password is stored encrypted by using electron [safeStorage module](https://www.electronjs.org/docs/latest/api/safe-storage) which can potentially prompt a warning to allow access to the system Keychain on Mac and Linux. Make sure to allow SendCrypt.

:::

If you don’t have **ssh** installed or you don’t have any keys configured, simply click on **Generate** to generate a new pair of SSH keys (RSA 4096 bit) and set them as your active SSH keys.


:::warning
Careful while generating new SSH keys, as clicking on the button **Generate** will automatically erase/replace any previous key named `sendcrypt_rsa` and `sendcrypt_rsa.pub`.

:::


## Register your SSH public key

Once your SSH keys are set up, you will need to transmit your public key to either your recipient if you don’t have a [SendCrypt account](https://sendcrypt.sib.swiss/register) or register it under your account.

Start by copying your SSH public key by clicking the blue button next to **SSH public key**: ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy85YWIyZDM3Mi1lYjJlLTQ1MzMtYmU2YS1lMTM2NWFlZmVkNDgvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDE0LjAyLjQ0LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.S2ysC7-4v53YBX0afGfPSIi403iAoDp2Vvi0hyIn1bE)

Then, head to your [SendCrypt account](https://sendcrypt.sib.swiss/settings/keys) where you should see your current SSH and GPG keys.

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy8wNzIyZDE1NC1mYjQ3LTQ2MjYtYjY4NC1mYmQyMzIyYzYyZWEvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDE0LjA2LjI5LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.R4Uzfwap_JJM-Ed2nXTfiABD0jwnHspkwyqUr04ByEQ)Then click on the **New SSH key** button, which will prompt you with a form to add your SSH public key:

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy9kMGUzZDUzZi1lYTNhLTQxOTctOGI5OC0zOTgwNTc4Yzk2MGQvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDE0LjA4LjAzLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.lry5SbUy8t0j1u9TcOHle_eBdS2OBlGJ9JwKA_ZI8DA)

You can define a title if you want and then paste your copied SSH public key in the **Key** form. Finally, click on **Add SSH key**.

If everything went well, you should see a banner confirming that you have successfully added your key and your key should now appear under **Authentication keys**.

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy9kZTJhYmQ2ZS01MzExLTQwNzUtYjhkOC1iM2NhYTk1MTMwMzkvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDE0LjA5LjE1LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.eCzi0c-pCI7yDaMw2kM6YvoJK-BBJDNXpct6YUgL2oY)

Your key will be automatically shared with any project that you are part of.

# Configure your GPG keys

SendCrypt makes extensive use of OpenPGP to prove your identity by signing the metadata file but also to securely encrypt your data before any transfer, ensuring that only the recipient will be able to decrypt it.

In the SendCrypt Desktop Application, click on **Settings** in the left panel to access the settings of the application.

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy8yZTI4MDdjNy1mZGJiLTRhOWEtYTgxYS02ZTNhZGI1ZWZlMzYvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDEzLjQ4LjQyLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.ZKIWZe4WNpz84JyoF4-jQcgfGmFXxPhMbyBV1wzg1ro)Scroll down until you see the **GPG** section.  ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy8wNjgzZmMwMi1hZjliLTQ2YzMtYjNiMC0zNTZlZTE2NWE1YTMvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDE0LjE3LjEzLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.5ufDEdMoPxYSLldHkPuWotNMfI6fLWSlTpvlHdOke4A)By default, no GPG key will be configured. You have two options:

* Import your own GPG private key
* Generate a new pair of GPG keys

## Importing a GPG private key

First, make sure that you private key is stored inside a file in ASCII armored format. 

You can use the following command to export your key:

```bash
gpg -a --export-secret-keys <your-key-ID-or-email> > private-key.asc
```

Then, click on the **Import** button which will prompt you with a dialog to select the file containing your GPG private key.

If everything went well, you should see that your key automatically selected as your **Signing key**.

## Generating a new pair of GPG keys


:::warning
The functionality to generate a new pair of GPG keys is only accessible to logged users as it requires access to the email of the user.

:::

SendCrypt allows you to directly generate a new pair of GPG keys (RSA 4096 bit) which will expire in 2 years.

Start by filling the **Passphrase** form with a strong password (make sure to store this password in a safe place) and then click on the **Generate** button. This will automatically generate a new pair of GPG keys protected with your password and set them as your active signing key.

## Register your GPG public key

Once your GPG keys are set up, you will need to transmit your public key to either your recipient==,== if you don’t have a [SendCrypt account](https://sendcrypt.sib.swiss/register)==,== or register it under your account.

Start by copying your GPG public key by clicking the blue button next to **Signing key**:

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy8yMTNjODMxMy1kYmQzLTRhYjktODY3NS00MDgyYjY3OTMyMzcvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDE0LjMwLjQyLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.OioTkWU8y5esOJk1n18VfIHTPZpVYkkMdBacG1SLIZU)

Then, head to your [SendCrypt account](https://sendcrypt.sib.swiss/settings/keys) where you should see your current SSH and GPG keys.

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy8wNzIyZDE1NC1mYjQ3LTQ2MjYtYjY4NC1mYmQyMzIyYzYyZWEvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDE0LjA2LjI5LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.R4Uzfwap_JJM-Ed2nXTfiABD0jwnHspkwyqUr04ByEQ)Then click on the **New GPG key** button, which will prompt you with a form to add your GPG public key:

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy84NWYyNDllOC0wYmFhLTQ1ZWUtOGM3Yy04MjY4NGRiMmVhZTAvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDE0LjMxLjQ4LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.5u5jT2zZGSiY71WJ46TEN8gxfOqbWObnHM7HgUT_Q9c)You can define a title if you want and then paste your copied GPG public key in the **Key** form. Finally, click on **Add GPG key**.

If everything went well, you should see a banner confirming that you have successfully added your key and your key should now appear under **Authentication keys**.

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy9jZTA3MTJiMi1hM2EyLTRmZTAtOGI2Yi0xMjBlODYwYTE5ZTYvU2NyZWVuc2hvdCAyMDI0LTAyLTE0IGF0IDE0LjM0LjM1LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzkwODIwOTAwLCJleHAiOjE3OTA5MDczMDB9.MtSy4KSG73e1ykZVHTlcg7kjwSvzb07IwcmxKaaJJvE)

Your key will be automatically shared with any project that you are part of.



:::warning
It’s important to note that if the UserID of the GPG public key does not match your current email address (which is indicated by the tag **Unverified** next to the email address, you will need to add your additional email address by following this [guide](https://clinbiokb.sib.swiss/doc/sendcrypt). If you don’t, your GPG public key will not be shared with any project that you are part of.

:::

# Configure the temporary directory

When a batch is sent throught the GUI, the tool needs to prepare the data before sending it which requires some storage. To achieve those steps, it uses by default a temporary directory. If you would like to change this directory, head to the **Settings**. Then under **Storage**, you will find the current temporary directory. Click on **Change location** and select a new directory (make sure you have the correct permissions).

 ![](https://clinbiokb.sib.swiss/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzEyNzQ1MDFhLWRiM2MtNDkwMS05ZGVhLTZiYzMwMmVhNTBjYy81YjFiNWQxOC1kMGNjLTRkOTktYmU2ZC1iZWY0YzdhODkxZTMvU2NyZWVuc2hvdCAyMDI0LTEyLTIwIGF0IDEuMTYuMTTigK9QTS5wbmciLCJ0eXBlIjoiYXR0YWNobWVudCIsImlhdCI6MTc5MDgyMDkwMCwiZXhwIjoxNzkwOTA3MzAwfQ.ZCdi473qJVFmncF0gX6vmvYVGKuTxt_HwgQQeJHZ-d8 " =800x599")

---

**Documents**

- [Getting started](https://clinbiokb.sib.swiss/s/sendcrypt/doc/getting-started-7uRWXFnHx7)
- [Configure SendCrypt](https://clinbiokb.sib.swiss/s/sendcrypt/doc/configure-sendcrypt-1dhTXiOj5T)
- [Send your first batch of data](https://clinbiokb.sib.swiss/s/sendcrypt/doc/send-your-first-batch-of-data-DC1mIePn6f)
- [SendCrypt CLI](https://clinbiokb.sib.swiss/s/sendcrypt/doc/sendcrypt-cli-MNIRTX3KqL)
- [Troubleshooting](https://clinbiokb.sib.swiss/s/sendcrypt/doc/troubleshooting-chx1lUHStZ)