> ## Documentation Index
> Fetch the complete documentation index at: https://docs.repocloud.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Deploy

> Paste a GitHub URL and let an AI agent deploy your project to a fresh VPS automatically

## AI Deploy

AI Deploy lets you deploy any public GitHub repository to a dedicated VPS without manual server setup. Paste a GitHub URL, select a server tier and AI model, and an AI agent provisions the server, analyzes the repository, and deploys the application — all while you watch the progress in a real-time chat interface.

<CardGroup cols={2}>
  <Card title="Zero Server Setup" icon="wand-magic-sparkles">
    The AI agent handles server provisioning, dependency installation, and application configuration automatically
  </Card>

  <Card title="Real-Time Chat" icon="comments">
    Watch the deployment progress in a live chat interface — ask questions, provide guidance, or let the agent work autonomously
  </Card>

  <Card title="Full Root Access" icon="terminal">
    Your deployed application runs on a dedicated VPS with root SSH access, just like any other VPS App
  </Card>

  <Card title="Deploy History" icon="clock-rotate-left">
    View and resume past AI Deploy sessions from your deployment history
  </Card>
</CardGroup>

## How It Works

<Steps>
  <Step title="Go to AI Deploy">
    Navigate to [repocloud.io/ai-deploy](https://repocloud.io/ai-deploy) or click **AI Deploy** on any app with the deploy-as-VPS toggle.
  </Step>

  <Step title="Paste a GitHub URL">
    Enter the HTTPS URL of a public GitHub repository (e.g., `https://github.com/owner/repo`).
  </Step>

  <Step title="Enter a Project Name">
    Choose a friendly name for your project (e.g., "my-project").
  </Step>

  <Step title="Select a Server Tier">
    Choose a server size starting from \$6/month (2 GB RAM). The \$3 tier is not available for VPS deployments.
  </Step>

  <Step title="Select an AI Model (Optional)">
    If model selection is enabled, choose the AI model that powers the deployment agent. A default model is pre-selected.
  </Step>

  <Step title="Deploy">
    Click **Deploy App**. The system provisions a fresh Ubuntu VPS and begins analyzing your repository.
  </Step>

  <Step title="Follow the Chat">
    You are redirected to a status page while the VPS provisions and the AI researches your repository. Once ready, the chat interface opens where you can watch the agent work, answer questions, or provide custom instructions.
  </Step>

  <Step title="Get Your Credentials">
    When deployment completes, your SSH credentials, server IP, and application URL are available in the chat and on the VPS manage page.
  </Step>
</Steps>

## Pre-Filled AI Deploy (Templates)

When you use the **deploy-as-VPS toggle** on a container app's deploy page (see [Deploy as VPS](/deployment/deploy-as-vps)), the AI Deploy form is pre-filled with that app's GitHub repository URL. The URL input is hidden and the page identifies which repository is being deployed.

You can also link directly to pre-filled deployments using query parameters:

```
https://repocloud.io/ai-deploy-template?owner=<github-owner>&repo=<github-repo>
```

## Requirements

* **RepoCloud account** with a verified email
* **\$1 minimum deposit** — free sign-up credit cannot be used for VPS deployments. After depositing at least \$1, your balance exceeds the \$3 threshold required for VPS access.
* **Public GitHub repository** — the repository must be publicly accessible

## Pricing

AI Deploy creates a standard VPS instance with the same fixed-tier pricing as any other VPS App:

| vCPU | RAM   | SSD    | Monthly |
| ---- | ----- | ------ | ------- |
| 1    | 2 GB  | 30 GB  | \$6     |
| 2    | 2 GB  | 40 GB  | \$9     |
| 2    | 4 GB  | 40 GB  | \$12    |
| 4    | 8 GB  | 80 GB  | \$24    |
| 8    | 16 GB | 160 GB | \$48    |
| 16   | 32 GB | 320 GB | \$96    |

Dedicated IPv4 is included at no extra charge. Billing starts when the VPS is provisioned.

## Deploy History

View your past AI Deploy sessions at [repocloud.io/ai-deploy/history](https://repocloud.io/ai-deploy/history). You can resume a previous session's chat to continue working with the agent on an existing deployment.

## After Deployment

Once the AI agent completes the deployment, your VPS is a standard VPS instance with all the same management features:

* SSH root access with the credentials shown in the chat and manage page
* Power controls (power off, power on, reboot)
* Browser console for emergency access
* Snapshots for point-in-time backups
* Resizing to larger tiers
* Custom domain via A-record

For full details, see [Managing VPS Apps](/manage/vps-apps).

## FAQ

<AccordionGroup>
  <Accordion title="What types of projects can AI Deploy handle?">
    AI Deploy works with any public GitHub repository that can run on a Linux server. It supports web applications, APIs, bots, static sites, and more. The AI agent reads the repository's documentation, Dockerfile, and configuration files to determine the best deployment approach.
  </Accordion>

  <Accordion title="Can I provide custom instructions?">
    Yes. The deploy form includes an optional custom instructions field where you can guide the AI agent — for example, specifying which branch to deploy, which ports to expose, or which environment variables to set.
  </Accordion>

  <Accordion title="What happens if deployment fails?">
    If the AI agent encounters an error it cannot resolve, the chat session remains open so you can troubleshoot together. The VPS itself is already provisioned, so you can also SSH in and debug manually. You are billed for the VPS from the time it is provisioned.
  </Accordion>

  <Accordion title="Is the VPS different from one I deploy manually?">
    No. An AI-deployed VPS is identical to any other VPS App — same manage page, same SSH access, same snapshots, same pricing. The only difference is that the AI agent handled the initial setup.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup>
  <Card title="Deploy Now" icon="rocket" href="https://repocloud.io/ai-deploy">
    Start an AI Deploy from the RepoCloud dashboard
  </Card>

  <Card title="Deploy as VPS" icon="toggle-on" href="/deployment/deploy-as-vps">
    Learn about the toggle that redirects catalog apps to AI Deploy
  </Card>

  <Card title="Managing VPS Apps" icon="sliders" href="/manage/vps-apps">
    Manage your AI-deployed VPS instance
  </Card>

  <Card title="API and MCP" icon="code" href="/api/introduction">
    Programmatically deploy VPS instances via the REST API
  </Card>
</CardGroup>