Pair Your Server

Pairing connects your home server to your SeaWise account. You only need to do this once per server.

How It Works

SeaWise uses a device pairing flow (similar to signing into a streaming app on a TV):

1. The client generates a pairing code

2. You enter the code on the SeaWise dashboard

3. You approve the connection

4. The client connects automatically

Steps

1. Open the Client Web UI

Go to http://your-server-ip:8082 in your browser.

2. Start Pairing

Click Start Pairing. A 10-character code appears on screen (e.g., ABCD-1234XY).

You have 10 minutes to complete the pairing before the code expires.

3. Enter the Code

Click the link in the client UI, or go to seawise.io and navigate to Connect Server.

Enter the pairing code.

4. Approve the Connection

Review the details:

• Your account email

• The server name

Click Approve Connection.

5. Done

The client web UI updates to show Connected with your server name and account email.

After Pairing

Once paired, the client:

• Maintains a persistent connection to SeaWise

• Reconnects automatically if the connection drops

• Sends a heartbeat every 30 seconds so the dashboard knows your server is online

• Survives reboots (if you used --restart unless-stopped)

Unpairing

To disconnect a server from your account:

1. Open the client web UI at http://your-server-ip:8082

2. Click Disconnect

3. Confirm the action

This removes the server from your SeaWise account. Your local services continue running — only the tunnels are removed.

Pairing a Second Server

You can pair multiple servers to the same account. Run the SeaWise client on each server and pair each one separately.

Next Steps

• Add your first service

• Client web UI guide