Workspaces

Connect to multiple Freedom Messenger servers from a single app. Family, work, community — switch between them in one tap.

How Workspaces Work

Each workspace is a connection to a separate Freedom Messenger server. You have one "home" workspace (the server you are currently on) and can add any number of remote workspaces.

• Home workspace — the server hosting the web app you are using. Uses cookie-based authentication.
• Remote workspaces — other Freedom Messenger servers. Each one stores its own server URL, optional label, and JWT token.

Adding a Workspace

1. Open the workspace switcher in the sidebar (pull down on mobile, or click the workspace icon on desktop).
2. Select "Add workspace."
3. Enter the server URL (for example, https://team.example.com).
4. Log in with your credentials for that server.
5. Optionally give the workspace a label (like "Work" or "Family").

Switching Between Workspaces

Tap any workspace in the switcher to switch to it. The chat list, messages, and settings will update to show the content from that server.

Inactive workspaces are polled every 60 seconds for unread messages. The tab badge (and app badge) shows the total unread count across all workspaces, so you never miss a message.

Exporting and Importing Workspaces

Moving to a new device? You can export your workspace list as an encrypted string and import it on another device.

Export

1. Open workspace settings.
2. Select "Export encrypted."
3. Enter a passphrase — this will be used to encrypt the data with AES-256-GCM.
4. Copy the resulting Base64 string and save it or share it securely with yourself.

Import

1. On your new device, open workspace settings.
2. Select "Import encrypted."
3. Paste the Base64 string and enter the same passphrase.
4. Your workspaces will be merged with any existing ones on this device.