How does the sync work?

You can sync your journal cross-platform between devices. That means you can access the same journal on multiple devices, no matter if they run Windows, macOS, iOS or Android. To do so, select the Cloud service you want to use in the app settings or trigger a sync manually by clicking the "sync" button on the main page. You will need to do that once for each device in order to login to the cloud storage - make sure to use the same cloud storage account on each device you wish to include into the sync. After that, the app syncs your journal automatically, without having to press the sync button manually. The data uploaded to the cloud is compressed and encrypted.
You can also move the database to another device without using the Cloud sync. You can export the complete database in the app settings ("Backup diary" button) and import the resulting .diary-file on another device with the "Import diary" button.

Which cloud storage option should I choose for sync?

Diarium supports multiple cloud storage services for syncing your data. You can use one of your existing accounts or create a new one - each account usually comes with a certain amount of free storage space (which can be expanded by subscribing to a paid plan, e.g. Microsoft 365, Google One or iCloud+). If you're unsure which one to pick, here's a quick breakdown of each option:

OneDrive

Login with your Microsoft account
Reliable & fast sync performance

Google Drive

Login with your Google account
Sync can be slightly slower compared to the other options

Dropbox

Login with your Dropbox account
Reliable & fast sync performance

iCloud

Login with your Apple account
Less recommended when using Android or Windows where manual reauthentication every 30 days is required
Reliable & fast sync performance

WebDAV

Use your own server or service that supports the WebDAV protocol (e.g. Nextcloud, Synology)
No reliance on third-party services, full control over your data
Requires some manual setup and technical knowledge
Sync performance can vary depending on the server being used

Can you journal together with another person, e.g. my partner?

Yes, you can share a journal together with someone else. All you need to do is to use the same Cloud account when setting up the Cloud Sync. Because the iCloud Sync automatically uses the Apple account you are signed in with on your device, you might need to use one of the other options (e.g. OneDrive, Google Drive, Dropbox) which allow you to choose what account to log in with.

Where are the sync files located?

The sync files are stored in your personal Cloud storage of the Cloud service you selected. For OneDrive, Diarium is syncing the data to the folder "Applications/Diarium". For GoogleDrive & WebDAV, you find it in the "Diarium" folder in the root of your cloud storage. For Dropbox, the data will be saved to the "Apps/Diarium" folder. For iCloud, the files cannot be seen directly, however the used Cloud storage space.
In order to make sure the Cloud Sync functions properly, please do not delete, modify or rename those files. Because these files are compressed & encrypted, it is not possible to view their contents by opening them in other programs. If you wish to view your journal in a human-readable format, please use the Export feature within the app.

[Android] I'm stuck during authentication/login

Diarium uses your default browser app for authenticating with the Cloud Service you selected (e.g. OneDrive). Some browsers do not always navigate back to Diarium after the authentication is complete, so Diarium cannot finish setting up the sync. To resolve this problem, you can set a different app (e.g. Google Chrome) as your default browser app in the Android settings. It only has to be your default app during the authentication process, you can switch back to your preferred browser app after you've successfully set up the Cloud Sync in Diarium.

Why is the sync not working for me?

In some cases, the sync might not work as expected. Some of the possible reasons include insufficient cloud space, a bad internet connection or sync-incompatible instances of Diarium (make sure you are running the latest app version on all connected devices).
It is also possible that the sync fails if the sync folder contents on your cloud storage are changed manually - please don't add or remove any files in those folders (see "Where is the data stored?"). In some cases, it can also help to reset the sync login credentials in the app settings.
Make sure you using the same Cloud service (e.g. OneDrive) in all your Diarium instances and are logged in with the same (e.g. Microsoft-) Account.
If you continue to have problems with the Cloud sync, please don't hesitate to ask for help in the support area.

How do I set up the WebDAV sync?

Settings up the WebDAV Sync can be a bit more tricky compared to the other sync options. If you are having problems with it, maybe these points can help:

Make sure you are entering the correct WebDAV-URL:
- In most cases you can not use the same URL that you use when accessing your Cloud storage in the browser. You may have to read the WebDAV documentation of your Cloud service system to find the correct WebDAV-URL
- If your WebDAV instance uses a non-default port, it might be required to append it to the URL (e.g. https://mydomain.com:1234)
- If you want to use a subfolder, make sure to append its name/path to the WebDAV-URL (e.g https://mydomain.com:1234/subfolder). In some cases it is required that you use a subfolder (e.g. the "webdav" subfolder on Synology servers)
- Make sure that the user you are using for the WebDAV Sync has access permissions (read + write) to the folder specified in the URL
- When using ownCloud/Nextcloud, you find the correct URL in the web interface by clicking on the bottom-left settings button. The URL should contain something like /remote.php/dav/files/
When you enter the wrong WebDAV credentials and the app shows an error, you can reenter them by clicking on the Reset login credentials button and reselect WebDAV from the sync options.
Some providers require an app password for WebDAV access, especially when two-factor authentication is enabled
When using https, make sure to have a valid and trusted SSL certificate on your server (you can get one for free from Let's Encrypt).
When using Synology, make sure you enabled the WebDAV server as described here.
pCloud is currently not recommended for use with the Cloud Sync due to problems/bugs on the side of pCloud