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

# How-to guides

> Practical steps for running your tools and workloads in microsandbox

<div className="msb-guides-overview">
  <div className="msb-guides-grid">
    <section className="msb-guide-group">
      <h2 id="running-agents"><span className="msb-guide-heading"><Icon icon="robot" size={16} /><span>Agents</span></span></h2>

      <ul className="not-prose">
        <li><a href="/how-to/agents/claude-code"><span>Run Claude Code</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/agents/codex"><span>Run Codex CLI</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/agents/opencode"><span>Run OpenCode</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/agents/openclaw"><span>Set up OpenClaw</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/agents/goose"><span>Run Goose</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/agents/gemini-cli"><span>Run Gemini CLI</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/agents/hermes-agent"><span>Set up Hermes Agent</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/agents/pi"><span>Run Pi</span><Icon icon="arrow-right" size={12} /></a></li>
      </ul>
    </section>

    <section className="msb-guide-group">
      <h2 id="development-environments"><span className="msb-guide-heading"><Icon icon="code" size={16} /><span>Development</span></span></h2>

      <ul className="not-prose">
        <li><a href="/how-to/development/vscode"><span>Connect VS Code</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/development/jetbrains-acp"><span>Connect JetBrains via ACP</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/development/code-server"><span>Run code-server</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/development/jupyterlab"><span>Run JupyterLab</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/development/vnc-desktop"><span>Open a VNC desktop</span><Icon icon="arrow-right" size={12} /></a></li>
      </ul>
    </section>

    <section className="msb-guide-group">
      <h2 id="browser-automation"><span className="msb-guide-heading"><Icon icon="globe" size={16} /><span>Browser automation</span></span></h2>

      <ul className="not-prose">
        <li><a href="/how-to/browser-automation/browser-use"><span>Run a browser agent</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/browser-automation/playwright"><span>Automate a browser</span><Icon icon="arrow-right" size={12} /></a></li>
      </ul>
    </section>

    <section className="msb-guide-group">
      <h2 id="working-with-workloads"><span className="msb-guide-heading"><Icon icon="gears" size={16} /><span>Workloads</span></span></h2>

      <ul className="not-prose">
        <li><a href="/how-to/file-processing/ffmpeg"><span>Transcode media with FFmpeg</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/file-processing/libreoffice-pdf"><span>Convert documents to PDF</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/plugins/terraform"><span>Vet a Terraform provider offline</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/data/migration-rehearsal"><span>Rehearse a database migration</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/web-automation/scrapy"><span>Crawl a site with Scrapy</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/automation/parallel-batch-jobs"><span>Process a batch in parallel</span><Icon icon="arrow-right" size={12} /></a></li>
      </ul>
    </section>

    <section className="msb-guide-group">
      <h2 id="sandbox-setup"><span className="msb-guide-heading"><Icon icon="box" size={16} /><span>Sandbox setup</span></span></h2>

      <ul className="not-prose">
        <li><a href="/how-to/docker/docker-in-sandbox"><span>Run Docker in a sandbox</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/docker/local-images"><span>Use local images</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/guest/systemd-services"><span>Boot with systemd</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/sandboxing/warm-workers"><span>Start warm workers from snapshots</span><Icon icon="arrow-right" size={12} /></a></li>
      </ul>
    </section>

    <section className="msb-guide-group">
      <h2 id="hosting"><span className="msb-guide-heading"><Icon icon="server" size={16} /><span>Deployment</span></span></h2>

      <ul className="not-prose">
        <li><a href="/how-to/docker/docker"><span>Run microsandbox in Docker</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/sandboxing/kubernetes"><span>Run microsandbox in Kubernetes</span><Icon icon="arrow-right" size={12} /></a></li>
      </ul>
    </section>

    <section className="msb-guide-group">
      <h2 id="storage"><span className="msb-guide-heading"><Icon icon="database" size={16} /><span>Storage</span></span></h2>

      <ul className="not-prose">
        <li><a href="/how-to/data/postgresql"><span>Run PostgreSQL</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/data/redis"><span>Run Redis</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/data/juicefs-s3"><span>Mount S3 with JuiceFS</span><Icon icon="arrow-right" size={12} /></a></li>
      </ul>
    </section>

    <section className="msb-guide-group">
      <h2 id="ci-automation"><span className="msb-guide-heading"><Icon icon="code-pull-request" size={16} /><span>CI/CD</span></span></h2>

      <ul className="not-prose">
        <li><a href="/how-to/ci-cd/github-actions-runner"><span>Run a GitHub Actions job</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/ci-cd/pr-checks"><span>Run isolated PR checks</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/ci-cd/compose-tests"><span>Run Docker Compose tests</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/ci-cd/preview-deploys"><span>Serve a preview deployment</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/automation/dependency-audits"><span>Schedule dependency audits</span><Icon icon="arrow-right" size={12} /></a></li>
      </ul>
    </section>

    <section className="msb-guide-group">
      <h2 id="observability"><span className="msb-guide-heading"><Icon icon="chart-line" size={16} /><span>Observability</span></span></h2>

      <ul className="not-prose">
        <li><a href="/how-to/metrics-backends/grafana-cloud"><span>Send metrics to Grafana Cloud</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/metrics-backends/grafana-alloy"><span>Forward metrics with Grafana Alloy</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/metrics-backends/otel-collector"><span>Inspect metrics with OpenTelemetry</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/metrics-backends/prometheus"><span>Send metrics to Prometheus</span><Icon icon="arrow-right" size={12} /></a></li>
        <li><a href="/how-to/metrics-backends/datadog"><span>Send metrics to Datadog</span><Icon icon="arrow-right" size={12} /></a></li>
      </ul>
    </section>
  </div>
</div>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.