Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -225,6 +225,7 @@
]
},
"openhands/usage/agent-canvas/customize-and-settings",
"openhands/usage/agent-canvas/mobile-access",
"openhands/usage/agent-canvas/critic",
"openhands/usage/agent-canvas/acp-agents",
"openhands/usage/agent-canvas/development",
Expand Down
52 changes: 52 additions & 0 deletions openhands/usage/agent-canvas/mobile-access.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
---
title: Phone & Tablet Access
description: Access Agent Canvas from a phone or tablet using Tailscale or ngrok.
---

If Agent Canvas is running on your computer, you can access it from a phone, tablet, or another device without exposing it to the public internet.

## Tailscale (Recommended)

[Tailscale](https://tailscale.com/) creates a private network between your devices. No port forwarding, DNS, or firewall rules are required.

### Setup

1. Install [Tailscale](https://tailscale.com/download) on both your computer and your phone or tablet.
2. Sign in with the same account on both devices.
3. Find your computer's Tailscale IP in the Tailscale app. It usually looks like `100.x.y.z`.
4. Start Agent Canvas on your computer:

```bash
agent-canvas
```

5. Open `http://<tailscale-ip>:8000/` in your phone or tablet browser.

That's it. The connection is encrypted and only devices in your Tailscale network can reach it.

<Tip>
If the mobile browser still points at `127.0.0.1` or `localhost`, open `Manage Backends` and edit the local backend's `Host / Base URL` to `http://<tailscale-ip>:8000`. If it keeps reverting, clear site data for the Agent Canvas URL in your browser settings and reload the page.
</Tip>

## ngrok (Remote / Public Access)

Use [ngrok](https://ngrok.com/) when Tailscale is not an option or when you need a temporary public URL. Because the URL is reachable from the internet, run Agent Canvas in public mode with a strong backend API key first:

```bash
export LOCAL_BACKEND_API_KEY="<choose-a-strong-secret>"
agent-canvas --public
```

Then start ngrok in a second terminal:

```bash
ngrok http 8000
```

Open the ngrok forwarding URL in your phone or tablet browser.

<Warning>
Do not expose Agent Canvas over the internet without authentication. Public mode requires users to enter `LOCAL_BACKEND_API_KEY` before the backend can be used. Without authentication, anyone with the URL can use your instance and the LLM API keys configured in it. See [VM / Self-Hosted Backend](/openhands/usage/agent-canvas/backend-setup/vm) for the full remote-access setup.
</Warning>

ngrok also supports OAuth, IP allowlists, and other access controls for additional protection.
Loading