Tutorial: Collaborate from Anywhere

So far everything runs on your laptop. This tutorial takes you beyond that: deploy a server so you can access your agents from your phone, share live sessions with teammates, and run agents on cloud sandbox hosts that keep working after you close your laptop.

Time: 15 minutes. Requires a Railway account (free tier works).

1. Deploy to Railway

Railway is the quickest way to get a multi-user Goalrail server running.

Go to railway.app and import the Goalrail repo from GitHub.
Railway detects the Dockerfile and deploys automatically with a managed Postgres database.
Once deployed, note your server URL (something like https://goalrail-production-xxxx.up.railway.app).

2. Connect your laptop

goalrail login https://your-server.up.railway.app
goalrail host https://your-server.up.railway.app

login authenticates you. host registers your machine so the server can dispatch agent work to it. You're now running agents through the deployed server.

3. Access from your phone

Open https://your-server.up.railway.app on your phone's browser (the same URL from step 1). You see the same web UI with the same sessions. Start a task on your laptop, check progress from your phone over lunch, answer an approval prompt from the coffee line.

4. Share a session with a teammate

In the web UI, click Share on any session. Send the link to a teammate. They open it in their browser and join in real time.

Now both of you can:

Watch the agent's output as it streams.
Send messages to the agent.
Comment on the agent's work.
Fork the session to try a different direction without affecting the original.

Only share EDIT with people you trust to run arbitrary code on your machine. A teammate with EDIT can drive the agent, which runs code on whatever machine hosts the session. Share read-only when you can. See Co-driving grants code execution on the host for details.

5. Run a cloud sandbox host

Want the agent to keep working after you close your laptop? Launch a cloud sandbox host from the web UI. The agent runs in a remote container and you check results whenever you're ready.

Set it up by adding a sandbox section to your server config. See Cloud Sandbox Host for the full setup guide.

What's next

Set up SSO with Google, GitHub, or Okta for your team.
Explore other deployment options: Docker, Render, Fly.io.
Build a custom agent that your whole team can use.