Docs
Features
Multi Device Sync
Using Syncthing

Using Syncthing

Note

This guide describes an alternative method for multi-device bookmark synchronization available to non-premium users. Gosuki+ users should use P2P Auto Sync instead.

Overview

Non-premium users can achieve basic multi-device bookmark synchronization using the following approach:

  1. HTML Autoimport feature to monitor bookmark files
  2. Third-party folder sync services like Syncthing
  3. Manual bookmark exports from mobile browsers

This method allows you to maintain consistent bookmarks across multiple devices, including desktops and mobile devices that cannot run GoSuki directly.

Setup Guide

1. Set Up Folder Synchronization

  1. Choose a sync directory (e.g., ~/shares/bookmarks)
  2. Install and configure Syncthing to synchronize this directory across all devices
  3. Add the directory to Syncthing on each device you want to sync

2. Configure GoSuki

Update your config.toml to monitor the synchronized directory (e.g., $HOME/shares/bookmarks):

[html-autoimport]
paths = ["$HOME/shares/bookmarks"]

Restart GoSuki to apply changes.

For devices running GoSuki (desktops, etc.), set up a cron job:

  • Create ~/.config/cron.d/gosuki-sync with:
    */5 * * * * gosuki export html $HOME/shares/bookmarks/bookmarks.html

For mobile devices (without GoSuki), manually export bookmarks from your browser as HTML to $HOME/shares/bookmarks/.

Install Syncthing

Configure Syncthing

  1. Open Syncthing web interface (http://localhost:8384)
  2. Add the bookmarks directory as a new folder
  3. Share the folder with other devices using their device IDs

Usage

  • Desktop devices: Cron job automatically exports bookmarks; auto-import module detects changes.

  • Mobile devices: Manually export bookmarks from browser to synchronized folder.

  • The result is a unified, consistent state of bookmarks across all connected devices—except on mobile devices, which retain their own isolated state.

  • On mobile, you can access the WebUI of any gosuki node, for example: http://laptop2.lan:2025.

Example 

  graph LR
    M(Mobile) -. manual exported .-> S(Syncthing)
    S <---> A[Laptop2] 
    S <---> B[Laptop1]

    M -. access webui .-> A

    classDef master fill:#6366f1,stroke:#3730a3,stroke-width:2px,font-weight:bold;
    classDef device fill:#e0e7ff,stroke:#6366f1,stroke-width:1.5px;
    classDef syncthing fill:#00c48c,stroke:#008b4d,stroke-width:1.5px,font-weight:bold;

    class A,B device
    class S syncthing

Notes

  • Mobile limitations: GoSuki cannot run on mobile platforms, so manual exports are required
  • Conflict resolution: Last-write-win strategy - for Title, Metadata and Description. Tags are merged.
  • File format: Use standard HTML bookmark format (e.g., Firefox’s “Bookmarks HTML Export”)

Tag Sync Limitation

This method only synchronizes URL, Title, and Description fields. Tags that are manually added in the Title field in the form of #tag1 #tag2 will be captured and merged by gosuki. Native browser tags (like firefox) will not be synchronized.

For a fully automated out of the box sync experience, consider using the P2P Auto Sync module.

P2P Auto Sync