Documentation

Everything you need to get started with Passo.

Quick Start

1. Sign up

Go to getpasso.app/auth and sign in with Google. Start your 30-day free trial.

2. Get your install command

After signing in, you'll see your dashboard with a personalized install command.

3. Run on your server

SSH into your Linux server and paste the install command. It takes about 2 minutes.

4. Access your browser

Your browser is now live at your personal URL. Access it from any device.

Requirements

✓
Linux server
Ubuntu 20.04+, Debian 10+, or similar. x86_64 architecture.
✓
Root or sudo access
The install script needs to install packages and configure services.
✓
1GB+ RAM recommended
Chromium needs memory. More RAM = smoother experience.
✓
Outbound internet access
The browser connects to Passo's relay server via WebSocket.

Installation

Your install command is unique to your account. Find it in your dashboard after signing in.

The command looks like:

curl -fsSL getpasso.app/i/XXXXXX | bash

This script will:

Install Chromium browser
Set up a virtual display (Xvfb)
Install and configure the Passo client
Create a systemd service for auto-start

How it works

Passo runs an isolated Chromium browser on your server. The browser's screen is streamed to our relay server via WebSocket, and you access it through your personal URL.

Your Server          Passo Relay          Your Phone
    │                     │                     │
    │  [Chromium + VNC]   │                     │
    │         │           │                     │
    │         └──WebSocket──►                   │
    │                     │◄──HTTPS──────────────┘
    │                     │     (Google OAuth)

Your browser is protected by Google OAuth — only the email you signed up with can access it.

Usage with OpenClaw

Passo was built for OpenClaw users. When your AI agent needs you to:

Log into a website
Complete 2FA/MFA
Solve a CAPTCHA
Handle any manual verification

Your agent can send you the Passo URL. Tap it, handle the task in the browser, and your agent continues.

To integrate with OpenClaw, add the browser-control skill:

# In your OpenClaw config, point browser-control to your Passo URL

Troubleshooting

Browser shows offline

Check if the Passo service is running on your server:

sudo systemctl status passo

Can't connect after server reboot

The service should auto-start, but you can manually restart it:

sudo systemctl restart passo

Browser is slow or laggy

This usually means low RAM. Chromium needs at least 512MB free. Consider upgrading your server or closing other applications.

Support

Need help? Email us at support@getpasso.app