> ## 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.

# Deployment issues

> DNS, SSL, custom domain, and promotion problems.

When the deploy is built but the site isn't reachable, the issue is almost always DNS or SSL.

## Quick checks

<Steps>
  <Step title="Is the build green?">
    Check the deploy log. If it failed, see [Build failures](/troubleshooting/build-failures).
  </Step>

  <Step title="Does the `*.vly.app` URL work?">
    Open the project's default URL. If yes, the issue is custom domain only.
  </Step>

  <Step title="Does DNS resolve correctly?">
    `dig app.yourcompany.com` should return the CNAME pointing to `cname.vly.app`. If not, DNS hasn't propagated; wait or check your DNS provider.
  </Step>

  <Step title="Is the SSL cert active?">
    Check Settings → Domains. Status should be "Active". If "Pending SSL", wait or click "Retry SSL".
  </Step>
</Steps>

## Common issues

<AccordionGroup>
  <Accordion title="'Pending DNS' for >1 hour" icon="alert-triangle">
    DNS records wrong or not propagated. Re-check with `dig` or [whatsmydns.net](https://whatsmydns.net).
  </Accordion>

  <Accordion title="'Pending SSL' for >30 minutes" icon="alert-triangle">
    Let's Encrypt rate limit. Wait an hour, click "Retry SSL".
  </Accordion>

  <Accordion title="Browser shows 'Your connection is not private'" icon="alert-triangle">
    Cert not yet issued, or browser cached an old one. Try incognito.
  </Accordion>

  <Accordion title="Apex domain not working" icon="alert-triangle">
    DNS providers vary in apex support. See [Custom domains → apex](/deployment/custom-domains#apex-domains).
  </Accordion>

  <Accordion title="Cloudflare-related issues" icon="alert-triangle">
    "Orange cloud" proxy ON when it should be OFF, or SSL/TLS mode "Flexible" causing redirect loops. See [DNS setup → Cloudflare](/deployment/dns-setup#cloudflare).
  </Accordion>
</AccordionGroup>

## Related

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

  <Card title="DNS setup" icon="globe" href="/deployment/dns-setup">
    Per-provider guides.
  </Card>

  <Card title="SSL certificates" icon="shield-check" href="/deployment/ssl-certificates">
    SSL specifics.
  </Card>
</CardGroup>


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