Skip to main content
Want to use your own domain instead of the default .vibecode.app URL? This guide walks you through connecting a custom domain to your deployed Vibecode web app.

​
Before You Start

You’ll need:
  • A deployed Vibecode web app (see Deploying Your Web App if you haven’t deployed yet)
  • A domain you own with access to its DNS settings (e.g. via Cloudflare, GoDaddy, Namecheap, etc.)

​
Step 1: Open the Domain Tab

In your deployment dashboard, click the Domain tab. Domain tab in the deployment dashboard

​
Step 2: Add Your Domain

Click the Add Custom Domain button. You’ll see a modal with two options. Add Custom Domain modal with 'I have a domain' and 'Maybe later' options Click “I have a domain” to continue.

​
Step 3: Enter Your Domain

Type in your domain name — just the domain, no http:// or https:// prefix. Domain input field with www redirect checkbox
  • Enter your domain (e.g. example.com)
  • Optionally check “Redirect www to this domain” if you want www.example.com to redirect to your apex domain
  • Click Save

​
Step 4: Configure DNS Records

After saving, Vibecode shows you the DNS records you need to add at your domain provider. The exact records depend on whether you’re connecting an apex domain or a subdomain.
DNS records for apex domain showing ALIAS and CNAME records
TypeNameTarget
CNAME or ALIAS@<your-project>.vibecode.run
CNAMEwww<your-project>.vibecode.run
The www record only appears if you enabled the www redirect in the previous step.
Some DNS providers don’t support CNAME records on the apex domain (@). In that case, use an ALIAS or ANAME record instead — most modern providers support this. See the provider guides below for specifics.

​
Step 5: Add Records at Your DNS Provider

Go to your DNS provider’s dashboard and add the records from the previous step. Here are direct links to guides for popular providers:

Cloudflare

Create DNS records on Cloudflare

GoDaddy

Add a CNAME record on GoDaddy

Namecheap

Create a CNAME record on Namecheap

Google Domains

Manage DNS records on Google Domains

Hostinger

Manage CNAME records on Hostinger

​
Step 6: Verify Your Domain

Once you’ve added the DNS records, go back to the Domain tab in Vibecode and click “Check now”. Vibecode will verify that your DNS records are set up correctly.
DNS changes can take anywhere from a few minutes to 24–48 hours to propagate. If verification fails, wait a bit and try again.
Once verified, you’ll see a green “Domain verified” banner confirming routing is correct. Click “Done” to finish, then deploy to activate your custom domain. Domain verified confirmation showing routing is correct

​
Troubleshooting

Troubleshoot section showing Cloudflare proxy tip Click “Troubleshoot” in the Domain tab to see common issues. Here are the most frequent ones:
If you’re using Cloudflare, make sure the DNS record is set to DNS-only mode (gray cloud icon), not Proxied (orange cloud). Cloudflare’s proxy can interfere with domain verification.Alternatively, if your provider blocks CNAME on the apex domain, use an ALIAS or ANAME record instead.
If you already have A or AAAA records pointing your domain somewhere else, they’ll conflict with the CNAME record. Remove the old A/AAAA records first, then add the CNAME.
DNS changes don’t take effect instantly. It can take up to 48 hours for records to propagate worldwide. If the check fails right after adding records, wait 15–30 minutes and try again. You can also try from a different browser — your current browser may have cached the old DNS response.
You can click “Remove domain” in the Domain tab to disconnect your custom domain and start the process from scratch.
Still stuck? Reach out via live support chat in the app, or join our Discord community for help.