Cloud Server Setup
Provision a dedicated cloud server, configure your project, and open it in VS Code in four steps.
Setup Steps
1. Subscribe
Go to /cloud/pricing, select a tier, and complete checkout. Stripe processes the payment and activates your subscription immediately.
2. Wait for provisioning
After checkout, your new server appears on /dashboard/servers with status Provisioning. Provisioning typically takes 2–5 minutes. The page updates automatically when provisioning completes and the server reaches active status.
3. Configure project name
Click the Configure button on your server card. Enter a URL-safe project name that:
- Is between 3 and 40 characters long
- Contains only lowercase letters, numbers, and hyphens (no spaces or special characters)
The project name becomes part of the server’s URL and cannot be changed after it is set.
4. Open in VS Code
Click Open in VS Code on the server card. VS Code opens with the server pre-configured — no manual connection setup required. See VS Code Extension for details on reviewing AI-proposed changes once connected.
How the Deep Link Works
When you click Open in VS Code, the dashboard fetches a pre-built deep link from the server and redirects your browser to a vscode:// URL. That URL carries your api_key and server address. VS Code intercepts the URL, passes the parameters to the Mahalaxmi extension, and the extension establishes the connection automatically — no copy-pasting of keys or host names needed.
The deep link is generated server-side and is single-use. Do not share it.
Server Lifecycle
A server passes through the following statuses during its lifetime:
- pending_payment — Waiting for payment confirmation from Stripe.
- provisioning — Infrastructure is being allocated (2–5 minutes).
- active — Server is running and ready to use.
- degraded — Server is running but health checks are failing.
- stopping — Server is shutting down.
- stopped — Server is stopped; no charges accrue.
- deleting — Deletion is in progress.
- deleted — Server has been permanently removed.
- failed — Provisioning or recovery failed unrecoverably.
Troubleshooting
Status shows “Degraded”
Your server is running but health checks are failing — it is operational but unhealthy. Try reloading the dashboard after a minute. If the status does not return to active, contact support at support@mahalaxmi.ai and include your server ID.
Status shows “Failed”
The server encountered an unrecoverable error and cannot be restarted automatically. Contact support@mahalaxmi.ai with your server ID. The support team will diagnose the failure and, if possible, provision a replacement server on the same subscription.
“Open in VS Code” does nothing
Ensure the Mahalaxmi VS Code extension is installed. See VS Code Extension for installation instructions.