Custom domains

LocalCan allows Public URLs (tunnels) to be created on a domain you own.

This option improves branding and creates a more professional look. Unlike Public URLs on the localcan.dev domain, custom domains never expire.

Availability

Custom domains are available on paid plans and work with HTTP Public URLs only, not TCP. The option is not shown on the Free plan.

Add and verify your domain

Custom domains are added and verified on the Dashboard↗. The Add Custom Domain… option in the desktop app opens the same page.

  1. Use a subdomain of a domain you own. For instance, if you own example.com, add preview.example.com.
  2. Add the CNAME record shown there at your DNS provider.
  3. Verification usually takes a few minutes. From then on, LocalCan handles the SSL/TLS certificate lifecycle for you.

Note for Cloudflare users

When adding this CNAME record on Cloudflare dashboard, set the Proxy status to DNS only instead of Proxied, otherwise LocalCan won't be able to verify the domain.

Use your domain

In the app. Verified domains appear under On Custom Domain when you click Add Public URL on an app's card. A domain still verifying shows as (pending), and one already attached to an endpoint shows as (in use).

From the CLI. Point a quick tunnel at your domain:

Shell
localcan http 3000 --domain preview.example.com

See Quick tunnels.

In a project file. Pin the domain to any service:

YAML
services:
  web:
    target: http://localhost:3000
    endpoints:
      - provider: localcan
        url: preview.example.com

Drop the file into ~/.localcan/projects/ and run localcan reload. See Configuration → Projects.

See guide: Setting up SaaS development environment with LocalCan

© 2026 LocalCan™. All rights reserved.