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

# DNS setup

> Provider-specific DNS guides for connecting custom domains to vly. Cloudflare, Namecheap, GoDaddy, Google.

DNS configuration is the longest part of [Custom domain](/deployment/custom-domains) setup, but each provider takes only a couple of minutes once you know where the records go.

## Cloudflare

1. DNS → Records → Add record.
2. Type: `CNAME`. Name: `app` (or your subdomain). Target: `cname.vly.app`. Proxy status: **DNS only** (orange cloud OFF).
3. For apex (`yourcompany.com`): Cloudflare auto-flattens CNAMEs at the apex — same record, name `@`.
4. SSL/TLS mode: **Full** (not Flexible).

## Namecheap

1. Domain List → Manage → Advanced DNS.
2. Add: Type `CNAME Record`. Host: `app`. Value: `cname.vly.app.` (trailing dot). TTL: Automatic.
3. For apex: Namecheap doesn't support ALIAS. Use A records:
   * Type `A`. Host `@`. Value `76.76.21.21`. (Add a second A record with the second anycast IP from vly.)

## GoDaddy

1. My Products → DNS → Manage.
2. Add → CNAME. Name: `app`. Value: `cname.vly.app`. TTL: 1 hour.
3. For apex: A records (GoDaddy doesn't support ALIAS).

## Google Domains / Cloud DNS

1. DNS → Custom records (or Cloud DNS zone).
2. Type: `CNAME`. Name: `app`. Data: `cname.vly.app.`
3. For apex on Cloud DNS: ALIAS supported. For Google Domains: A records.

## AWS Route 53

1. Hosted zones → \[your domain] → Create record.
2. Record type: `CNAME`. Record name: `app`. Value: `cname.vly.app`.
3. For apex: Route 53 supports `ALIAS` natively. Type: `A`. Toggle "Alias". Value: `cname.vly.app.`

## Verifying

After adding records, check propagation:

```bash theme={null}
dig app.yourcompany.com CNAME
# expect: cname.vly.app
```

Or use [whatsmydns.net](https://whatsmydns.net) for global propagation status.

## Related

<CardGroup cols={3}>
  <Card title="Custom domains" icon="link" href="/deployment/custom-domains">
    The full walkthrough.
  </Card>

  <Card title="SSL certificates" icon="shield-check" href="/deployment/ssl-certificates">
    What happens after DNS resolves.
  </Card>

  <Card title="Troubleshooting" icon="life-buoy" href="/troubleshooting/deployment-issues">
    Common DNS issues.
  </Card>
</CardGroup>


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