Cypass Hybrid 🎓 Tutorial

☁️ Premise about Nextcloud +


To use Cypass Hybrid and Cypass Nextcloud, you need a Nextcloud account.

What is Nextcloud and what you need to use it


Nextcloud is a self-hosted cloud, an open source platform for managing and synchronizing files, calendars, contacts and much more.
Unlike Google Drive or Dropbox, your data remains under your control,
hosted on a server that you manage yourself.

How to install your Nextcloud



To have your own Nextcloud you need a server to install it on. The most common options are:

Web hosting — many providers offer hosting with PHP and MySQL compatible with Nextcloud. Just upload the files, create a database and follow the installation
wizard.
A Raspberry Pi — an affordable home solution. For just a few euros you can have your personal cloud always running, connected to your home network.
A VPS server — a virtual server rented on platforms like Hetzner, Contabo or similar. More flexible and powerful, ideal if you want more control.
An old PC or NAS — any machine that stays on can become your Nextcloud server.

In all cases you will need: PHP, a database (MySQL, MariaDB or SQLite)
and a web server (Apache or Nginx).

No server? You can use a Nextcloud provider



If you do not have the technical knowledge or the necessary equipment to install Nextcloud on your own,
you can rely on a provider that hosts it for you.
There are services that offer ready-to-use Nextcloud accounts, often with a basic free plan.

Keep in mind, however, that in this case the situation is similar to Google Drive or similar services:
your data is stored on someone else's servers.
Compared to the big tech giants, these are still more transparent and privacy-oriented realities,
but you will not have the full control you would have with your own installation.

In summary


Want maximum control? Install Nextcloud on your own server or hosting.
Want a simple and immediate solution? Use a third-party Nextcloud provider.
Either way, Nextcloud remains a better choice for privacy compared to traditional cloud services.


To use Cypass Hybrid and Cypass Nextcloud, you need a Nextcloud account.

What is Nextcloud and what you need to use it


Nextcloud is a self-hosted cloud, an open source platform for managing and synchronizing files, calendars, contacts and much more.
Unlike Google Drive or Dropbox, your data remains under your control,
hosted on a server that you manage yourself.

How to install your Nextcloud



To have your own Nextcloud you need a server to install it on. The most common options are:

Web hosting — many providers offer hosting with PHP and MySQL compatible with Nextcloud. Just upload the files, create a database and follow the installation
wizard.
A Raspberry Pi — an affordable home solution. For just a few euros you can have your personal cloud always running, connected to your home network.
A VPS server — a virtual server rented on platforms like Hetzner, Contabo or similar. More flexible and powerful, ideal if you want more control.
An old PC or NAS — any machine that stays on can become your Nextcloud server.

In all cases you will need: PHP, a database (MySQL, MariaDB or SQLite)
and a web server (Apache or Nginx).

No server? You can use a Nextcloud provider



If you do not have the technical knowledge or the necessary equipment to install Nextcloud on your own,
you can rely on a provider that hosts it for you.
There are services that offer ready-to-use Nextcloud accounts, often with a basic free plan.

Keep in mind, however, that in this case the situation is similar to Google Drive or similar services:
your data is stored on someone else's servers.
Compared to the big tech giants, these are still more transparent and privacy-oriented realities,
but you will not have the full control you would have with your own installation.

In summary


Want maximum control? Install Nextcloud on your own server or hosting.
Want a simple and immediate solution? Use a third-party Nextcloud provider.
Either way, Nextcloud remains a better choice for privacy compared to traditional cloud services.

☁️ Nextcloud - Workspace +

To use Cypass Hybrid, you need to configure a workspace on Nextcloud.

Here is how to do it.

1. Creating the directory



Inside your Nextcloud account, create a new directory.
This will be the folder used by the app to save data.

2. Choosing the name



You can assign any name you prefer to the directory.
However, pay attention to one important detail.
If you intend to use the Cypass version integrated into Nextcloud in the future, avoid naming it "Cypass", because that version automatically creates a directory with that name.

3. WebDAV URL



Once the directory has been created, you need to obtain its WebDAV URL.
To do so:
enter the newly created directory and copy the URL from the address bar.
Then open Cypass Hybrid.
In the configuration screen, press the "Get WebDAV URL" button.
Enter:
the URL you copied
the username of your Nextcloud account
The app will automatically complete the field with the correct URL.

4. App password



The last required parameter is the app password.
To create it:
go to your Nextcloud account settings
enter the Security section
and scroll down to the entry dedicated to creating app passwords
Generate a new password and use it in the Cypass Hybrid configuration.

To use Cypass Hybrid, you need to configure a workspace on Nextcloud.

Here is how to do it.

1. Creating the directory



Inside your Nextcloud account, create a new directory.
This will be the folder used by the app to save data.

2. Choosing the name



You can assign any name you prefer to the directory.
However, pay attention to one important detail.
If you intend to use the Cypass version integrated into Nextcloud in the future, avoid naming it "Cypass", because that version automatically creates a directory with that name.

3. WebDAV URL



Once the directory has been created, you need to obtain its WebDAV URL.
To do so:
enter the newly created directory and copy the URL from the address bar.
Then open Cypass Hybrid.
In the configuration screen, press the "Get WebDAV URL" button.
Enter:
the URL you copied
the username of your Nextcloud account
The app will automatically complete the field with the correct URL.

4. App password



The last required parameter is the app password.
To create it:
go to your Nextcloud account settings
enter the Security section
and scroll down to the entry dedicated to creating app passwords
Generate a new password and use it in the Cypass Hybrid configuration.

☁️ Cypass Hybrid – Initial Configuration +

When you open Cypass Hybrid for the first time, you will need to choose the language and the graphic theme.
You will then be taken to the configuration screen.

Here you have two options:

1 - create a new configuration
2 - use an existing configuration (for synchronisation)
👉 We will cover this second option later.

🔐 Creating a new configuration



If you are creating a new configuration, the first step is to set the master password.
It must meet the required criteria, but you can also generate one automatically by clicking "Suggest a secure password".

☁️ Connecting to Nextcloud



At this point you will need to enter the parameters to connect the app to your Nextcloud account:

- WebDAV URL
- Nextcloud account username
- App password

If you want to avoid entering the app password every time you start the app, you can enable the option "Remember the app password on this device".

👉 The password will be saved locally, but always in encrypted form.

✅ Completing the configuration



After entering all the data, press "Finalise configuration".
You will then be taken to the screen for enabling two-factor authentication (2FA).

🔑 Two-factor authentication (2FA)



Enabling 2FA is optional.

If you do not want to enable it right away, press "Skip, I do not want to enable it now".

If you do want to enable it:
- save the QR code in a safe place
- add the service in your TOTP app
- enter the 6-digit code generated
- press "Verify"

When you open Cypass Hybrid for the first time, you will need to choose the language and the graphic theme.
You will then be taken to the configuration screen.

Here you have two options:

1 - create a new configuration
2 - use an existing configuration (for synchronisation)
👉 We will cover this second option later.

🔐 Creating a new configuration



If you are creating a new configuration, the first step is to set the master password.
It must meet the required criteria, but you can also generate one automatically by clicking "Suggest a secure password".

☁️ Connecting to Nextcloud



At this point you will need to enter the parameters to connect the app to your Nextcloud account:

- WebDAV URL
- Nextcloud account username
- App password

If you want to avoid entering the app password every time you start the app, you can enable the option "Remember the app password on this device".

👉 The password will be saved locally, but always in encrypted form.

✅ Completing the configuration



After entering all the data, press "Finalise configuration".
You will then be taken to the screen for enabling two-factor authentication (2FA).

🔑 Two-factor authentication (2FA)



Enabling 2FA is optional.

If you do not want to enable it right away, press "Skip, I do not want to enable it now".

If you do want to enable it:
- save the QR code in a safe place
- add the service in your TOTP app
- enter the 6-digit code generated
- press "Verify"

☁️ Cypass Hybrid – How it works +

Cypass Hybrid works, in most of its functions, identically to Cypass.

Regarding the creation of categories and entries, you can therefore refer to the tutorials of the basic version.

However, there is a fundamental difference that makes Cypass Hybrid even more interesting from a security standpoint.

In the local version of Cypass:

- matrices and entries are saved encrypted on the device

In Cypass Hybrid instead:

- matrices are saved exclusively locally
- entries are saved on Nextcloud

This separation introduces an additional layer of security:
a critical part of the system remains on the local device while the synchronised data is managed through Nextcloud.

While using the app, you may notice some differences compared to the local version, always related to this architecture.
For example, in the settings you will find a section dedicated to the Nextcloud configuration, which is not present in the basic version.

Cypass Hybrid works, in most of its functions, identically to Cypass.

Regarding the creation of categories and entries, you can therefore refer to the tutorials of the basic version.

However, there is a fundamental difference that makes Cypass Hybrid even more interesting from a security standpoint.

In the local version of Cypass:

- matrices and entries are saved encrypted on the device

In Cypass Hybrid instead:

- matrices are saved exclusively locally
- entries are saved on Nextcloud

This separation introduces an additional layer of security:
a critical part of the system remains on the local device while the synchronised data is managed through Nextcloud.

While using the app, you may notice some differences compared to the local version, always related to this architecture.
For example, in the settings you will find a section dedicated to the Nextcloud configuration, which is not present in the basic version.

🔄 Cypass Hybrid – Synchronisation +

Cypass Hybrid allows you to synchronise the app across multiple devices.

However, it is important to understand a fundamental concept.
Synchronisation happens automatically only for data saved on Nextcloud.

This does not mean that a full synchronisation is not possible, but that an additional step is required to include local data as well.

Let us look at a practical example.

On the first device, the user creates a category called Test
and inside it an entry called Sample.

At this point the situation is as follows:

- locally → the Test category is present with its matrix
- on Nextcloud → the Test category is present with the Sample entry
- also on Nextcloud → the security files are present as well

Of course, everything is encrypted.

Now the user wants to use the app on a second device as well.

During the initial configuration they select Synchronise the account
and enter the same Nextcloud parameters used on the first device.

The app recognises the account and asks for:

- the master password
- and optionally the 2FA code

Once the login is complete, the user enters the Categories Area.

But here they notice a difference.

On the first device the Test category is visible,
while on the second device no category is present.

This happens because:

on the second device, locally, the matrix is not yet present,
while on Nextcloud the data is present but is not sufficient on its own.

To display the entries correctly, the category with its matrix is also required.

At this point one final step is needed.

The user goes back to the first device and exports the Test category,
setting an encryption key.

They then switch to the second device and import the category using the Import a category button, entering the same key.

At this point the synchronisation is complete.

From now on:

every new entry created in the Test category, from any of the devices, will be immediately available on the other one as well.

📌 Important

Every time a new category is created, to synchronise it on other devices it will be necessary to:
export it from the first device and import it on the others.

Cypass Hybrid allows you to synchronise the app across multiple devices.

However, it is important to understand a fundamental concept.
Synchronisation happens automatically only for data saved on Nextcloud.

This does not mean that a full synchronisation is not possible, but that an additional step is required to include local data as well.

Let us look at a practical example.

On the first device, the user creates a category called Test
and inside it an entry called Sample.

At this point the situation is as follows:

- locally → the Test category is present with its matrix
- on Nextcloud → the Test category is present with the Sample entry
- also on Nextcloud → the security files are present as well

Of course, everything is encrypted.

Now the user wants to use the app on a second device as well.

During the initial configuration they select Synchronise the account
and enter the same Nextcloud parameters used on the first device.

The app recognises the account and asks for:

- the master password
- and optionally the 2FA code

Once the login is complete, the user enters the Categories Area.

But here they notice a difference.

On the first device the Test category is visible,
while on the second device no category is present.

This happens because:

on the second device, locally, the matrix is not yet present,
while on Nextcloud the data is present but is not sufficient on its own.

To display the entries correctly, the category with its matrix is also required.

At this point one final step is needed.

The user goes back to the first device and exports the Test category,
setting an encryption key.

They then switch to the second device and import the category using the Import a category button, entering the same key.

At this point the synchronisation is complete.

From now on:

every new entry created in the Test category, from any of the devices, will be immediately available on the other one as well.

📌 Important

Every time a new category is created, to synchronise it on other devices it will be necessary to:
export it from the first device and import it on the others.