1
0
mirror of https://github.com/vrtmrz/obsidian-livesync.git synced 2024-12-12 09:04:06 +02:00
obsidian-livesync/docs/quick_setup.md
2023-06-01 16:19:14 +09:00

3.8 KiB

Quick setup

The plugin has so many configuration options to deal with different circumstances. However, there are not so many settings that are actually used. Therefore, The Setup wizard has been implemented to simplify the initial setup.

Note: Subsequent devices are recommended to be set up using the Copy setup URI and Open setup URI.

The Setup wizard

Open the 🧙‍♂️ Setup wizard in the settings dialogue. If the plugin has not been configured before, it should already be open.

  • Discard the existing configuration and set up
    If you have changed any settings, this button allows you to discard all changes before setting up.

  • Do not discard the existing configuration and set up
    Simply reconfigure. Be careful. In wizard mode, you cannot see all configuration items, even if they have been configured.

Pressing Next on one of the above options will put the configuration dialog into wizard mode.

Wizard mode

Let's see how to use it step-by-step.

Remote Database configuration

Remote database configuration

Enter the information for the database we have set up.

Test database connection and Check database configuration

We can check the connectivity to the database, and the database settings.

Test Database Connection

Check whether we can connect to the database. If it fails, there are several possible reasons, but first attempt the Check database configuration check to see if it fails there too.

Check database configuration

Check the database settings and fix any problems on the spot.

This item may vary depending on the connection. In the above case, press all three Fix buttons.
If the Fix buttons disappear and all become check marks, we are done.

Confidentiality configuration

Encrypt your database in case of unintended database exposure; enable End to End encryption and the contents of your notes will be encrypted at the moment it leaves the device. We strongly recommend enabling it. And Path Obfuscation also obfuscates filenames. Now stable and recommended.
Encryption is based on 256-bit AES-GCM.
These setting can be disabled if you are inside a closed network and it is clear that you will not be accessed by third parties.

Next

Go to the Sync Settings.

Discard existing database and proceed

Discard the contents of the Remote database and go to the Sync Settings.

Sync Settings

Finally, finish the wizard by selecting a preset for synchronisation.

Select any synchronisation methods we want to use and Apply to initialise and build the local and remote databases as required. If All done! is displayed, we are done. Automatically, Copy setup URI will open and we will be asked for a passphrase to encrypt the Setup URI.

Set the passphrase as you like.
The Setup URI will be copied to the clipboard, which you can then transfer to the second and subsequent devices in some way.

How to set up the second and subsequent units

After installing Self-hosted LiveSync on the first device, select Open setup URI from the command palette and enter the setup URI you transferred. Afterwards, enter your passphrase and a setup wizard will open.
Answer the following.

  • Yes to Importing LiveSync's conf, OK?
  • Set it up as secondary or subsequent device to How would you like to set it up?.

Then, The configuration will take effect and replication will start. Your files will be synchronised soon! You may need to close the settings dialog and reopen it to see the settings fields populated properly, but they will be set.