Skip to content
Scalekit Docs
Talk to an EngineerDashboard
DEVELOPER KIT
Tools and examples to accelerate your integration
Build with AIIntegrate auth with AI coding agents
Reference & toolingImplement auth with SDKs, REST APIs, OpenAPI specs, and Postman collections
Testing UtilitiesTest and debug auth integrations locally
RESOURCES
Guides, references, and community resources
IntegrationsConnect external identity providers and platforms
WorkflowsAutomate user lifecycle and auth events with webhooks
Code SamplesCopy and adapt code examples by language

Add a custom domain on development

Development environments use the assigned Scalekit URL. Custom domains require Production and Customization Pro.

A Development environment cannot use a branded custom domain. Configure Custom Domain stays disabled, with the hint: custom domains are available on Production after you upgrade to the Customization Pro add-on.

Use the assigned Development environment URL for local work. When you need auth.yourapp.com, switch to Production and follow Branded custom domains.

Before you start

Section titled “Before you start”
  • You can open the environment (Development or Production) from the header switcher
  • For a branded hostname, you can edit DNS for a domain you own
  • Customization Pro is billed at $99/month and includes custom domains, watermark removal, custom email provider, and custom email templates

  1. Open the Development environment

    Section titled “Open the Development environment”

    In the header, click the environment name (right of the workspace name).

    Choose the Development environment you use for local work.

  2. Open Custom Domain

    Section titled “Open Custom Domain”

    In the left nav, under Customize, click Custom Domain.

    The page shows Custom Domain Add-on, the Environment URL, and a Live badge.

  3. Copy the Development environment URL

    Section titled “Copy the Development environment URL”

    Copy the Environment URL (for example scalekit-xxxxx-dev.scalekit.cloud).

    Use that host in Development redirect URLs, SDK environmentUrl, and local tests. See Manage environments.

    Configure Custom Domain is disabled on Development. Hover it to read the Production + Customization Pro requirement.

  4. Configure a branded domain on Production

    Section titled “Configure a branded domain on Production”

    Switch the header to a Production environment.

    Open Customize > Custom Domain and click Configure Custom Domain.

    If Customization Pro is not on this environment, Scalekit opens the Customization Pro Add-on $99/month dialog. Click Upgrade, then continue with the CNAME steps in Branded custom domains.

Verify

Section titled “Verify”

Development

  1. Open the Environment URL in a browser
  2. Confirm the hosted login or admin page loads over HTTPS
  3. Confirm Development redirect URLs use that host, not a production hostname

Production (after upgrade)

  1. Configure Custom Domain is enabled
  2. DNS verifies and the branded host serves HTTPS
  3. Production redirect URLs use the branded host

Common questions

Section titled “Common questions”
Can I attach auth.dev.yourapp.com to Development?

Not through Custom Domain. That page only enables CNAME on Production with Customization Pro. Keep Development on the assigned *-dev.scalekit.cloud URL.

Can I reuse the production hostname in Development?

No. Use the Development environment URL so cookies and redirect URLs never collide with Production.