Skip to content

SilentSuite Bridge

SilentSuite Bridge is a local daemon that translates between CalDAV/CardDAV and the Etebase protocol. It runs on your machine and makes SilentSuite compatible with any calendar, contacts, or tasks app that supports CalDAV/CardDAV -- including Thunderbird, macOS Calendar, GNOME Calendar, Windows Calendar, Outlook, and more.

How It Works

Your App (CalDAV/CardDAV)
        |
http://localhost:37358/
        |
SilentSuite Bridge (local)
        | (encrypted)
SilentSuite Server

The bridge handles encryption/decryption locally. Your data is still end-to-end encrypted -- the bridge just presents it as standard CalDAV/CardDAV to your apps.

Supported data types:

  • Calendars (CalDAV / VEVENT)
  • Tasks (CalDAV / VTODO)
  • Contacts (CardDAV / VCARD)

Install

Linux / macOS:

bash
curl -fsSL https://silentsuite.io/bridge/install.sh | sh

Windows (PowerShell):

powershell
irm https://silentsuite.io/bridge/install.ps1 | iex

The installer will:

  1. Download the correct binary for your OS and architecture
  2. Install it to ~/.local/bin/
  3. Optionally set up auto-start
  4. Open the browser for first-time login

Docker

bash
docker run -d --name silentsuite-bridge \
  -p 37358:37358 \
  --restart=always \
  silentsuite/bridge

Then open http://localhost:37358/.web/ to log in.

First-Time Setup

1. Log In

After installation, run:

bash
silentsuite-bridge --login

This opens your browser to a login page. Enter your SilentSuite email and password. The bridge authenticates with the server and stores your session locally.

2. Note Your Connection URLs

After successful login, the browser shows your CalDAV/CardDAV URLs:

FieldValue
CalDAV URLhttp://localhost:37358/your@email.com/
CardDAV URLhttp://localhost:37358/your@email.com/
UsernameYour SilentSuite email
PasswordYour SilentSuite password

You can always find these URLs by:

  • Opening the dashboard at http://localhost:37358/.web/
  • Using the system tray menu (Copy CalDAV URL / Copy CardDAV URL)

3. Start the Bridge

bash
silentsuite-bridge

The bridge will:

  • Start the CalDAV/CardDAV server on localhost:37358
  • Show a system tray icon (green = connected, yellow = warning, red = error)
  • Sync automatically in the background

Dashboard

The bridge serves a status dashboard at:

http://localhost:37358/.web/

The dashboard shows:

  • Connection status
  • Account info
  • Last sync time
  • CalDAV/CardDAV URLs with copy buttons
  • Recent sync log

Auto-Start

Install Auto-Start

bash
silentsuite-bridge --install-autostart

This configures the bridge to start when you log in:

  • Linux: Creates a systemd user service
  • macOS: Creates a launchd agent
  • Windows: Adds a startup registry entry

Remove Auto-Start

bash
silentsuite-bridge --remove-autostart

Environment Variables

VariableDefaultDescription
SILENTSUITE_SERVER_URLhttps://server.silentsuite.ioEtebase server URL
SILENTSUITE_LISTEN_ADDRESSlocalhostIP address to listen on
SILENTSUITE_LISTEN_PORT37358Port to listen on
SILENTSUITE_DATA_DIRPlatform-specificData storage location
SILENTSUITE_SYNC_INTERVAL900 (15 min)Sync interval in seconds
SILENTSUITE_LOG_LEVELINFOLog level (DEBUG, INFO, WARNING, ERROR)

For self-hosted SilentSuite:

bash
export SILENTSUITE_SERVER_URL=https://sync.your-domain.com
silentsuite-bridge

CLI Reference

bash
silentsuite-bridge                    # Start the bridge
silentsuite-bridge --version          # Show version
silentsuite-bridge --login            # Browser-based login
silentsuite-bridge --manual-login     # CLI login (for headless systems)
silentsuite-bridge --install-autostart  # Install auto-start
silentsuite-bridge --remove-autostart   # Remove auto-start
silentsuite-bridge --no-tray          # Start without system tray

Troubleshooting

Bridge won't start

Check that you've logged in first:

bash
silentsuite-bridge --login

Can't connect from your app

  1. Verify the bridge is running: open http://localhost:37358/.web/ in your browser
  2. Check the tray icon color (green = OK, red = error)
  3. Check the dashboard sync log for errors

System tray not visible (GNOME)

GNOME removed native tray support. Install the AppIndicator extension to restore it. KDE, XFCE, and other desktop environments support the tray natively.

Firewall blocking

Ensure localhost:37358 is not blocked by your firewall. The bridge only listens on localhost -- it never accepts connections from other machines.

Next Steps

Once the bridge is running, set up your apps:

Released under the AGPL-3.0 License.