Skip to main content

Devices synchronization

Wispar has an optional cloud syncing feature to synchronize your database on multiple devices. It uses PocketBase to mirror the app's database.

You can either use Wispar Sync, a hosted sync service, or self-host the sync backend to stay in control of your data.

Wispar Sync (hosted)​

Wispar Sync is the easiest way to keep your devices in sync without managing any infrastructure.

warning

Before choosing this option, please take the time to read the Privacy policy.

1. Create an account

  1. Open the Wispar app and navigate to Cloud sync settings.
  2. Ensure the toggle is set to Wispar Sync (this is the default).
  3. Tap on Need an account? to switch to registration mode.
  4. Enter your email and a strong password, then tap Sign up.

2. Verify your email

  • For security reasons, your account must be verified before you can start syncing.
  • Check your inbox for a verification email from Wispar.
  • Click the verification link inside the email.
info

If you don't receive the email, you can use the Resend email button in the app (available after a failed login attempt with an unverified account).

3. Sign in and sync

  1. Return to the login screen in Wispar.
  2. Enter your credentials and tap Login.
  3. Once authenticated, your data will begin its initial sync.
  4. You can toggle Background Sync to allow Wispar to keep your data updated automatically while you are using the app.
info

Syncing only happens when the app is open.

Self-hosted​

warning

Do not expose your PocketBase instance to the internet unless you are aware of the risks and know what you are doing!

  1. Download PocketBase: Download the latest executable for your operating system.

  2. Launch the server: Open your terminal in the folder where you downloaded the file and run:

    ./pocketbase serve

  3. Initial setup: Access the dashboard at http://127.0.0.1:8090/_/ to create your initial admin account.

  4. Prepare schema: Download or copy the tables.json file from the Wispar repository.

  5. Import collections: In the PocketBase sidebar, go to Settings > Import collections.

  • Paste the JSON content or upload the file.
  • Ensure "Merge with existing collections" is toggled ON before clicking Import.
  1. Create your Wispar user:
  • Navigate to the Collections menu and select the users table.
  • Click + New record.
  • Enter an email and password. (Note: The email doesn't need to be real unless you plan to configure mail settings later).
  • Important: Toggle the Verified switch to ON. If this is off, Wispar will reject the login.
  1. Connect Wispar: Open the Wispar app, select Self-Hosted in the sync settings, and enter your Server URL (e.g., http://your-ip:8090). That's it!