Public URLs

Custom domains

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

This option improves branding and creates a more professional look. Unlike Public URLs on LocalCan.dev domain, these never expire.

To use your own domain with LocalCan, it needs to be a subdomain of a domain you own. For instance, if you own example.com, you could use preview.example.com as your custom domain. To set it up, you will need to add a CNAME record on your DNS provider's dashboard.

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.

LocalCan will handle domain verification and the SSL/TLS certificate lifecycle for you. The entire process usually takes a few minutes.

Configure with YAML

LocalCan 3.0 Beta

YAML project files and the localcan CLI are new in 3.0. See Installation to install the beta.

Once a custom domain is verified for your account, you can pin it to any service in a project file:

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