Skip to content

Syncs

Jump to bottom
Matthias Urhahn edited this page Aug 28, 2024 · 3 revisions

Syncs

A synchronization connector (sync) is responsible for upload data from themselves, and downloading other devices data.

Multiple syncs can be used at the same time. If there is overlap between devices, the latest data is used.

Syncs don't know what type of data they exchange. They only know the module ID and some meta data. Only the module itself can encode/decode the data.

How data is written, encoded, updated or even when new data is downloaded or updated, is up to each sync implementation.

Google Drive

Octi uses Google drive app-scoped folders. These are hidden folders in your drive that only the app that created it can use, and an app using it can only access that folder and nothing else in your Google Drive.

Creation

You don't need to create an extra account if you already have a Google account.

Linking devices

Linking devices is not needed, you just need to use the same Google account with Octi on each device.

Recovery

It's your Google account.

Account deletion

You probably don't want to delete your Google account, but you can delete Octi's specific data:

K-Server

An external open-source server by @d4rken.

A good choice if you don't want to use Google Drive, or don't want to log some devices into the same Google account.

Data is encrypted on-device. The encryption key is never uploaded, so the server can't decode the data.

There is a free server being hosted by me (for as long as there is capacity), but more may be setup in the future, and you are free to host your own.

Creation

Account creation is free an anonymous.

Just click Create account and a random account name + password is generated and saved on your device.

Linking devices

  • On the first device that is already logged in:
    • Go to your sync services, click on the K-Server account that you want to share and click Link new device.
    • You will see a new screen with a long block of text.
    • Exchange the text directly or use the option to display it as QR-Code-
    • Keep this text secret! It contains your encryption key.
  • On the second device that you want to link:
    • Go to sync services, click K-Server and select Link to existing account-
    • Now copy&paste the text block from your first device or scan it's QR-Code.

Linking a new device to an existing account requires two things: The encryption key and an "invite".

Each device has their own account+password combination. To get this, an existing device has to invite the new device, by telling the server to generate an invite-code. With the invite-code, a new device can use it one-time to talk to the server and get account+password that is linked to your account. Being able to access the server is not enough though.

Data on the server is encrypted and the server doesn't know the encryption key. It's never send anywhere. You need to get this key from another device. When linking devices, the encryption key is also encoded in the text block (and QR-Code).

Recovery

There is currently no way to recover your account if you don't have access to any device that is still logged in.

Account deletion

There is currently no direct way to delete an account, but any idle accounts are just deleted after a while.

Clone this wiki locally