Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Custom Domains

Use your own domain for authentication instead of the default Aero2 subdomain. For example, use auth.yourapp.com instead of yourapp.aero2.dev.

Setup Process

Add domain in the dashboard

Navigate to your application's settings and enter the custom domain you want to use (e.g., auth.yourapp.com).

Configure DNS

Add a CNAME record pointing your custom domain to your Aero2 subdomain:

auth.yourapp.com  CNAME  yourapp.aero2.dev

Verify

Aero2 checks that the DNS record is configured correctly:

POST /api/applications/:slug/custom-domain/verify

SSL provisioned

Once verified, an SSL certificate is automatically provisioned for your custom domain. No manual certificate management is required.

Remove domain

To remove a domain:

DELETE /api/applications/:slug/custom-domain

Benefits

  • Consistent branding — Users see your domain throughout the authentication flow
  • Cookie isolation — Authentication cookies are scoped to your own domain
  • Trust — Users are more likely to trust a login page on your domain
  • Email deliverability — Authentication emails can be sent from your domain