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

# Get Started

> From install to production in six steps

Monk is an AI DevOps agent that lives in your IDE. You tell it what you want, and it handles the rest — from containers and infrastructure to databases and monitoring. This page walks you through the full journey.

<img src="https://mintcdn.com/monk-d20f97b6/unKZV-MfUSGg29zP/assets/monk_wizard_inst.gif?s=40ecac0020af79235ffd85ca6c6878df" alt="Monk setup" height="200" className="rounded-lg" data-path="assets/monk_wizard_inst.gif" />

***

## 1. Install Monk

Monk runs as a native extension in VS Code, Cursor, Windsurf, Antigravity, or any VS Code-compatible editor. Installation takes about two minutes.

Click your IDE to install the extension directly:

<CardGroup cols={4}>
  <Card title="VS Code" icon="code" href="vscode:extension/monk.vscode-monk" />

  <Card title="Cursor" icon="arrow-pointer" href="cursor:extension/monk.vscode-monk" />

  <Card title="Windsurf" icon="wind" href="windsurf:extension/monk.vscode-monk" />

  <Card title="Antigravity" icon="wand-magic-sparkles" href="antigravity:extension/monk.vscode-monk" />
</CardGroup>

When you download the extension, the Monk chat window opens and guides you through the one-time setup: sign up for a free trial (no credit card required), wait for the runtime to install in the background, and open a project folder. Once everything is green, you are ready.

<Card title="Full installation guide" icon="download" href="/getting-started/installation">
  Detailed steps, system requirements, and troubleshooting
</Card>

***

## 2. Connect Your Coding Agent

Monk exposes its capabilities over MCP so your coding agent can call Monk for deployment, infrastructure, and operations tasks while you keep building code.

The Monk MCP server is enabled automatically during setup — no manual step needed. The last step in the setup screen links you to the guide for your agent. Pick yours below:

<CardGroup cols={3}>
  <Card title="VS Code / Copilot" icon="code" href="/getting-started/mcp-vscode-copilot" />

  <Card title="Cursor" icon="arrow-pointer" href="/getting-started/mcp-cursor" />

  <Card title="Windsurf" icon="wind" href="/getting-started/mcp-windsurf" />

  <Card title="Claude Code" icon="sparkles" href="/getting-started/mcp-claude-code" />

  <Card title="Codex" icon="terminal" href="/getting-started/mcp-codex" />

  <Card title="Gemini CLI" icon="message" href="/getting-started/mcp-gemini-cli" />

  <Card title="Antigravity" icon="wand-magic-sparkles" href="/getting-started/mcp-antigravity" />
</CardGroup>

<Note>
  Agent connection is optional. You can always talk to Monk directly in the built-in chat window (`Cmd+Shift+M`).
</Note>

<Card title="MCP setup overview" icon="plug" href="/getting-started/mcp-getting-started">
  How Monk MCP works, what it configures, and common patterns
</Card>

***

## 3. First Deployment

Open your project, then tell your coding agent (or Monk directly):

```
deploy this project
```

Monk analyzes the code, builds containers, provisions cloud infrastructure, and wires everything together. You will be asked for a cloud provider, a region, and credentials — nothing else.

A typical first deployment finishes in five to fifteen minutes. When it is done you get live URLs, service health, and an estimated monthly cost.

<Card title="First deployment walkthrough" icon="rocket" href="/getting-started/first-deployment">
  Step-by-step guide with example prompts and common scenarios
</Card>

***

## 4. Autonomous Operations

After your first deployment, Monk keeps your system running and gives you tools to manage it without writing infrastructure code.

**Watcher** monitors your services around the clock and alerts you on Slack when something needs attention. **CI/CD** can be set up with a single prompt so every push triggers a new deployment. And you can scale, migrate, or reconfigure services at any time through natural language.

<CardGroup cols={2}>
  <Card title="How autonomous operations work" icon="wand-magic-sparkles" href="/getting-started/autonomous-operations">
    What Monk handles on its own vs. what it asks you
  </Card>

  <Card title="Watcher setup" icon="bell" href="/prompting/watcher-setup">
    Continuous monitoring and Slack alerts
  </Card>

  <Card title="CI/CD setup" icon="arrows-rotate" href="/prompting/setting-up-cicd">
    Auto-deploy on every code push
  </Card>

  <Card title="Prompting guide" icon="lightbulb" href="/prompting/how-prompting-works">
    Tips for getting the most out of Monk
  </Card>
</CardGroup>

***

## 5. Connect Your Cloud

Monk follows a bring-your-own-infrastructure model. Everything runs on your cloud accounts. Monk asks for credentials when it needs them, but you can also set them up ahead of time.

<CardGroup cols={2}>
  <Card title="AWS" icon="cloud" href="/getting-started/credentials-aws">
    IAM access key and secret key
  </Card>

  <Card title="Google Cloud" icon="cloud" href="/getting-started/credentials-gcp">
    Service account JSON key
  </Card>

  <Card title="Microsoft Azure" icon="cloud" href="/getting-started/credentials-azure">
    Service principal with client secret
  </Card>

  <Card title="DigitalOcean" icon="cloud" href="/getting-started/credentials-digitalocean">
    Personal access token
  </Card>

  <Card title="Hetzner" icon="cloud" href="/getting-started/credentials-hetzner">
    API token
  </Card>
</CardGroup>

Monk also integrates with service providers like MongoDB Atlas, Redis Cloud, Netlify, Vercel, and Auth0. Credentials for these are requested automatically when you first use them.

<Card title="All credentials and permissions" icon="key" href="/getting-started/obtaining-credentials">
  Full reference for every provider, including minimum IAM policies
</Card>

***

## 6. Getting Help

If something goes wrong, start by asking Monk directly — it has full context about your project and infrastructure.

For bugs, use the built-in **Report a Bug** button in the Monk panel. It collects environment details automatically and sends them straight to the engineering team.

<img src="https://mintcdn.com/monk-d20f97b6/mdba6K68lgBwZJfs/assets/report_bug_v2.gif?s=ef322d0e826af7e4db7ce047fd0a8331" alt="Report a bug from the extension" height="200" className="rounded-lg" data-path="assets/report_bug_v2.gif" />

<CardGroup cols={2}>
  <Card title="Help & support channels" icon="life-ring" href="/getting-help">
    Bug reports, feature requests, community forum, and direct contact
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/prompting/troubleshooting">
    Common issues and how to resolve them
  </Card>
</CardGroup>
