Remote Access

Access your agent from any device over Tailscale, VPN, or your local network.

Jean2 binds to 0.0.0.0:8742 by default, so it's already reachable from other machines on your network. The question is just how to get a clean connection from your phone or laptop to the server.

Tailscale is the simplest way. It gives every machine a stable IP and encrypts traffic automatically.

Set up the server

  1. Install Tailscale on the machine running Jean2
  2. Start Jean2:
jean2 start
  1. Find your machine's Tailscale IP:
tailscale status

You can also find all devices in the Tailscale admin console.

Connect from any device

On your phone, laptop, tablet. Any device on your tailnet with a browser.

  1. Open the Jean2 web client (or desktop app)
  2. Click the server switcher (top-left, next to the connection indicator)
  3. Click Add Server...
  4. Enter a name and the server's Tailscale IP with port (e.g. http://100.x.x.x:8742)
  5. Paste your API token if auth is enabled
  6. Click Add Server

You're connected. The server appears in the switcher from now on. Switch between local and remote servers anytime.

HTTPS

If the web client is served over HTTPS, browsers block connections to plain HTTP endpoints. Mixed content policy. For instructions on setting up TLS with certificates or a reverse proxy, see TLS / HTTPS.

Without Tailscale

Tailscale is the easiest option, but any way to reach the server works. The same Add Server flow applies. Just enter the URL.

  • Same network: Use the machine's local IP (http://192.168.x.x:8742)
  • VPN: Use whatever IP your VPN assigns
  • Public: Set up a reverse proxy (nginx, Caddy) with TLS. Then add the server using your domain

Custom port

The default port is 8742. To change it, set in ~/.jean2/.env:

JEAN2_PORT=8080

Then use the custom port when adding the server.