docs: add connectivity guide

This commit is contained in:
Mohamed Boudra
2026-08-04 00:42:34 +02:00
parent 3a9d39b63a
commit 74dea38456
7 changed files with 103 additions and 12 deletions
+4 -9
View File
@@ -2,7 +2,7 @@
title: Security
description: "Security model for Paseo: architecture overview, connection methods, relay encryption, and best practices."
nav: Security
order: 4
order: 5
category: Getting started
---
@@ -58,20 +58,15 @@ If you believe a pairing offer has been compromised, restart the daemon to gener
By default, the daemon listens on `127.0.0.1:6767` (localhost only). This is safe for local CLI usage but not reachable from your phone or other devices.
For relay and Tailscale setup instructions, see [Connectivity](/docs/connectivity).
### Socket file (CLI only)
For maximum isolation, you can configure the daemon to listen on a Unix socket file instead of a TCP port. This prevents any network access entirely, only processes on the same machine can connect. The CLI supports this mode, but the mobile app and web interface require a network connection.
### VPN access
If you prefer direct connections over the relay, you can use a VPN like [Tailscale](https://tailscale.com). Tailscale creates a private network between your devices, so you can access your daemon without exposing it to the public internet.
To set this up:
1. Install Tailscale on your machine and phone and join them to the same [tailnet](https://tailscale.com/kb/1136/tailnet)
2. Configure the daemon to listen on your Tailscale IP (e.g., `100.x.y.z:6767`)
3. Add your Tailscale hostname to `hostnames` and `cors.allowedOrigins`
4. Add the daemon as a direct connection in the Paseo app using the Tailscale address
Use a VPN such as [Tailscale](https://tailscale.com) when you want a direct connection outside your local network. The VPN encrypts the traffic and keeps the daemon off the public internet. Bind the daemon to its VPN address, set a Paseo password, then add that address as a direct connection in the client.
### Binding to 0.0.0.0