Cloud Onboarding

This guide walks you through every step from signup to your first AI coding session.

Overview

Getting started with AgentOS Cloud takes about 5 minutes:

1. Create an account
2. Add your SSH key
3. Choose a plan and subscribe
4. Launch your environment
5. Connect and start coding

Step 1: Create an Account

Go to runagentos.com/dashboard.

You'll be prompted to create an account using:

• Email and password
• Google account
• GitHub account

After signing up, you'll land on your dashboard.

Step 2: Add Your SSH Key

Before you can provision a VM, you need to add an SSH key. This is how you'll connect securely.

Find Your SSH Key

macOS/Linux:

cat ~/.ssh/id_ed25519.pub
# or for RSA keys:
cat ~/.ssh/id_rsa.pub

Windows (PowerShell):

Get-Content ~/.ssh/id_ed25519.pub
# or:
Get-Content ~/.ssh/id_rsa.pub

Don't Have an SSH Key?

Generate one:

ssh-keygen -t ed25519 -C "your-email@example.com"

Press Enter to accept defaults. Then copy the public key:

cat ~/.ssh/id_ed25519.pub

Add to AgentOS Cloud

1. In the dashboard, find the SSH Keys panel
2. Click Add
3. Enter a name (e.g., "MacBook", "Work Laptop")
4. Paste your public key (starts with ssh-ed25519 or ssh-rsa)
5. Click Add key

Your key appears with its fingerprint. You can add multiple keys if you use different machines.

Step 3: Choose a Plan

With your SSH key added, you'll see the plan selector:

Select your plan and click Subscribe.

You'll be redirected to Stripe's secure checkout. Enter your payment details and confirm.

After payment, you're redirected back to the dashboard with an active subscription.

Step 4: Launch Your Environment

Now the fun part. Click Launch environment.

What happens:

1. We provision a VM on Fly.io in San Jose (sjc)
2. Your SSH key is injected for secure access
3. AgentOS and Claude Code are pre-installed
4. You get a unique subdomain like abc123.vm.runagentos.com

This takes about 60 seconds. Watch the status change from "provisioning" to "running".

Step 5: Connect to Your VM

Once running, you have two ways to connect:

Option A: SSH (Recommended for Setup)

Copy the SSH command from your dashboard:

ssh dev@abc123.vm.runagentos.com

Replace abc123.vm.runagentos.com with your actual subdomain.

Option B: Browser (AgentOS UI)

Click Open AgentOS to launch the web UI directly.

Your subdomain: https://abc123.vm.runagentos.com

Step 6: Login to Claude Code

If using Claude Code (recommended), you need to authenticate once:

claude login

Follow the prompts to authorize with your Claude account.

Step 7: Start Coding

You're ready! Create your first session:

Via SSH

cd ~/projects
claude

Via Browser

1. Open your AgentOS subdomain
2. Click + New Session
3. Select Claude Code
4. Choose a working directory
5. Start chatting with your AI assistant

What's Installed

Your VM comes pre-configured with:

• AgentOS - Running on port 3011, accessible via your subdomain
• Claude Code - Pre-installed, just needs claude login
• Node.js 20 - For JavaScript/TypeScript projects
• Python 3.12 - For Python projects
• Git - For version control
• tmux - For session persistence

Quick Reference

Troubleshooting

SSH Connection Refused

• Check your SSH key is correctly added (fingerprint matches)
• Ensure VM status is "running"
• Try: ssh -v dev@your-subdomain for verbose output

VM Stuck on "Provisioning"

• Wait up to 2 minutes for first-time setup
• If stuck longer, try destroying and re-launching

Claude Login Fails

• Ensure you have a valid Claude account
• Check internet connectivity on the VM
• Try: claude logout then claude login again

Next Steps

• SSH Access Guide - Port forwarding, IDE integration
• Billing & Plans - Manage subscription, upgrade/downgrade
• Session Management - Create and manage AI sessions