AI Surfer OS · Cohort Setup Guide

Before you start: you need your xCloud server running Hermes (the same agent server from your cohort setup). That's it. Everything below runs on that one server.

The setup

Open your server's Web Terminal

In xCloud, open your Hermes server and click Web Terminal. You'll land on a root@…# command prompt, right in your browser. Nothing to install on your computer.

≈ 1 min · click only

Paste one command

Paste the line below and press Enter. It runs for ~2-3 minutes and does the entire setup for you (details below the steps).

curl -fsSL https://theaisurferos.com/install | bash

≈ 3 min · fully automatic

Open your secure link & sign in

When it finishes it prints your secure URL and login. Open the https:// link, sign in with username surfer and the password it shows you, and go to the Chat tab. Your agent is already connected. 🏄

≈ 30 sec · you're live

WHAT THE COMMAND PRINTS WHEN IT'S DONE:

https://<your-server>.sslip.io 🔒

What that one command handles for you

✓Installs AI Surfer OSand keeps it running through reboots, automatically (pm2)
✓Connects it to your Hermes agentgenerates and mirrors the secure key on both sides, no manual editing
✓Turns on a real HTTPS lockfree Let's Encrypt certificate on a <your-ip>.sslip.io hostname, no domain to buy
✓Sets a private passwordHTTP login wall so only you can reach your dashboard

If something looks off

The chat says "Couldn't reach Hermes": Run hermes gateway restart in the terminal, wait ~10 seconds, then reload the dashboard.
I don't know my password: It's saved on the server in ~/ai-surfer-os/.env.local as DASHBOARD_PASSWORD.
The browser didn't ask me to log in: Your browser remembered your earlier sign-in. Open the link in a private/incognito window to see the login prompt everyone else gets.
I want to run it again: Totally safe. The command is idempotent, re-running it just updates everything in place.