• English
  • Remosidian Guide

    Remosidian can host a vault in two ways:

    • CLI host: run npx remosidian from a vault folder.
    • Obsidian plugin: install the free Remosidian Host plugin from Feishu Download.

    The Obsidian plugin is not listed in the Obsidian community plugin directory — download it directly from the official site above and enable it from your vault's Community plugins settings.

    Start From The CLI

    cd ~/Documents/MyVault
    npx remosidian

    Remosidian starts a local host for the current vault folder, opens a short pairing window, and prints a QR code for the mobile app.

    Start From The Remosidian Host Obsidian Plugin

    Download the free plugin from Feishu Download, then install it into the target vault:

    <your-vault>/.obsidian/plugins/remosidian-host/
      main.js
      manifest.json
      styles.css   # if included

    Then open Obsidian on desktop, go to Settings -> Community plugins -> Installed plugins, enable Remosidian Host, open its settings, and click Show QR Code. The plugin is not in the community plugin marketplace — download it from Feishu Download.

    Remote Access

    By default, the CLI and plugin host can advertise a Cloudflare Tunnel. Use --access=local when you only want LAN pairing, --access=https://<your-url> for your own tunnel, and --access=<host> for Tailscale or another stable host.

    npx remosidian --access=local
    npx remosidian --access=remote --force
    npx remosidian --access=https://<your-url>
    npx remosidian --access=<stable-host>
    npx remosidian --access=<host>,<fallback>

    Legacy aliases still work: --local, --relay, --host, --fallback-hosts, --remote, and --tunnel.

    The plugin host is desktop-only because it starts a local server inside Obsidian's desktop process.