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

# Quickstart: deploy AgentTeam Email

> Get AgentTeam Email running on your own infrastructure and verify your first connected domain.

This is the shortest path to a working self-hosted AgentTeam Email instance. The full setup contract is in the [self-host setup guide](/self-host/setup); use this page as the execution path once you understand the required inputs.

<Steps>
  <Step title="Choose a runtime">
    Use Docker Compose for a single-host install or Helm for Kubernetes.

    <CardGroup cols={2}>
      <Card title="Docker Compose" icon="docker" href="/self-host/docker-compose">
        Run the stack from the repository root with `docker compose`.
      </Card>

      <Card title="Helm" icon="dharmachakra" href="/self-host/helm">
        Install the chart from the GHCR OCI artifact.
      </Card>
    </CardGroup>
  </Step>

  <Step title="Prepare the admin instance">
    Configure the public hostname, admin Cloudflare OAuth app, service-level Cloudflare Worker, R2 archive bucket, internal service secrets, and optional admin transactional SMTP settings described in the setup guide.

    <Card title="Self-Host Setup" icon="server" href="/self-host/setup">
      Required Cloudflare, Worker, R2, secret, SMTP, and first-domain setup requirements.
    </Card>
  </Step>

  <Step title="Expose the web server">
    Route the configured public hostname to the web server. The same origin serves the web app and `POST /rpc/agent-mail/ingest/v1/{connectionPublicId}`.

    <Card title="Public Ingress" icon="route" href="/self-host/public-ingress">
      Use direct ingress, Cloudflare Tunnel, Tailscale Funnel, or another operator-owned reverse proxy.
    </Card>
  </Step>

  <Step title="Start the stack">
    For Compose, start the containers:

    ```bash theme={null}
    docker compose up -d
    docker compose ps
    ```

    For Helm, install or upgrade the release:

    ```bash theme={null}
    helm upgrade --install atemail oci://ghcr.io/agentteamhq/agentteam-email \
      --namespace agentteam-email \
      --create-namespace \
      -f values.yaml
    ```
  </Step>

  <Step title="Sign in and provision a domain">
    Open the configured public hostname, sign in, connect Cloudflare through the web UI, select the mail zone, and let AgentTeam Email provision DNS, Email Routing, Worker state, and archive bindings for that domain.

    <Card title="Domain Provisioning" icon="cloud" href="/usage/domain-provisioning">
      Domain setup is a signed-in user flow, not an admin environment-variable flow.
    </Card>
  </Step>

  <Step title="Validate the deployment">
    Check the health endpoint, verify the ingest route rejects unsigned requests, send test mail, and confirm the R2 archive objects and mailbox delivery.

    <Card title="Validation" icon="check" href="/self-host/validation">
      Deployment checks for web, ingest, archive, inbound delivery, and outbound sending.
    </Card>
  </Step>
</Steps>