Skip to main content
Use your own domain or subdomain for your HelloLeo projects. Perfect for production deployments and professional branding.

Domain Options

Default Subdomain

Every published project gets an automatic subdomain:
  • Format: your-project-name.helloleo.app
  • No configuration needed
  • Works immediately after publishing

Custom HelloLeo Subdomain

Choose your own subdomain from the Publish Modal:
  • Format: myproject.helloleo.app
  • Must be unique and available
  • Change it anytime
  • Follows naming rules (lowercase, numbers, hyphens)

Custom Domain

Use your own domain:
  • Format: app.yourdomain.com
  • Requires DNS configuration
  • Full control over your branding
  • Available on Pro and Business plans

Setting Up a Custom Subdomain

  1. Click “Publish” to open the Publish Modal
  2. In the Subdomain section, enter your desired subdomain
  3. Click Save to update
  4. Your project redeploys with the new URL

Setting Up a Custom Domain

Step 1: Configure DNS

Add a CNAME record pointing to HelloLeo:
CNAME records work for subdomains (e.g., app.yourdomain.com). For root/apex domains (e.g., yourdomain.com), use a DNS provider that supports CNAME flattening (such as Cloudflare) and point it to custom.helloleo.app.

Step 2: Add Domain in HelloLeo

  1. Open the Publish Modal
  2. Go to the Custom Domain section
  3. Enter your domain (e.g., app.yourdomain.com)
  4. Click Verify Domain
  5. Wait for DNS verification and SSL certificate generation

Step 3: Publish

Click “Update Published Version” to deploy with your custom domain.

How It Works

When you publish with a custom domain, HelloLeo:
  1. Registers your domain with our edge network
  2. Issues an SSL certificate automatically via Cloudflare
  3. Routes traffic from your domain to your published project
SSL certificates are provisioned automatically and renew without any action on your part.

Domain Requirements

  • Subdomains: 1-63 characters, lowercase letters, numbers, and hyphens
  • Cannot start or end with a hyphen
  • Must be unique - not already in use by another project
  • Reserved names: www, api, admin, mail, ftp, localhost, test, staging, dev, app

Troubleshooting

Domain Verification Fails

  • Check DNS propagation: Use nslookup.io to verify your records
  • Wait for propagation: DNS changes can take up to 48 hours
  • Verify CNAME target: Must point to custom.helloleo.app
  • Check domain format: No typos in domain name

SSL Certificate Issues

  • DNS not propagated: SSL provisioning requires DNS to resolve correctly first
  • Invalid DNS configuration: Verify CNAME record points to custom.helloleo.app
  • Domain already in use: Check if the domain is used by another project or service

Domain Not Working

  • Check deployment status: Ensure project is published
  • Verify SSL certificate: Check certificate status in the Publish Modal
  • Clear browser cache: Try incognito mode
  • DNS propagation: May need more time

Availability

Custom domains are available on:
  • Leo Pro - Included with subscription
  • Leo Business - Included with subscription
View pricing

Publishing Projects

Learn about publishing

Project Settings

Configure your project