---
title: Remote Workspaces
description: Connect to workspaces on remote machines via encrypted WebSocket.
---

Claudette can connect to workspaces on another machine over an encrypted WebSocket connection. The local app discovers or connects to a remote server and displays remote repos, agents, and terminals alongside local ones.

:::caution[Use with your own account only]
Agents started on a remote Claudette server run under whatever Claude credentials are configured on the *server* machine. If you pair multiple devices to a server signed into your Claude Pro/Max account, all of those devices share that single subscription identity.

[Anthropic's Consumer Terms](https://www.anthropic.com/legal/consumer-terms) prohibit making your account "available to anyone else." Pair only your own devices to a server tied to a Pro/Max subscription. If you need to share access with a teammate, use API-key authentication on the server and have your teammate sign in with their own credentials.
:::

## Sharing from the Desktop App

Click **Share this machine** in the sidebar. The server starts automatically as a subprocess — no separate installation required. The server is embedded in the Claudette binary (gated behind the default-enabled `server` feature).

The **Share this machine** modal also renders the connection string as a QR code so you can pair the [Claudette mobile app](/claudette/features/mobile-app/) by scanning with your phone.

On startup the server prints a connection string:

```
claudette-server v0.8.0 listening on wss://0.0.0.0:7683
Name: Work Laptop

Connection string (paste into Claudette):
  claudette://work-laptop.local:7683/aBcDeFgH1234...
```

## Headless Server (Standalone)

For headless machines without a GUI, the standalone server binary is still available:

```bash
# Build and install the standalone server binary
cargo install --path src-server

# Start it (generates a TLS certificate and pairing token on first run)
claudette-server
```

## Connecting from the Local App

### Automatic (LAN)

If both machines are on the same network, the server appears automatically in the sidebar under **Nearby**. Click **Connect** and enter the pairing token when prompted.

### Manual

Click **+ Add remote** in the sidebar footer and paste the full connection string. Claudette authenticates, stores a session token, and reconnects automatically on future launches.

## Server Management

```bash
# Regenerate the pairing token (revokes all existing sessions)
claudette-server regenerate-token

# Print the current connection string
claudette-server show-connection-string

# Bind to a specific interface or port
claudette-server --bind 192.168.1.50 --port 9000

# Disable mDNS advertisement
claudette-server --no-mdns
```

## Security

All traffic is encrypted with **TLS**. The local app pins the server's certificate fingerprint on first connection (**trust-on-first-use**), similar to SSH's `known_hosts`. This means:

- The first connection requires manual verification of the pairing token
- Subsequent connections are authenticated automatically via the pinned certificate
- If the server's certificate changes, you'll be prompted to re-verify
