Quick start

Get a local HTTPS domain and a shareable Public URL (tunnel) for an app running on your machine in a few minutes.

The steps below use the desktop app on macOS and Windows. On Linux, or if you prefer the terminal, follow the CLI quick start.

1. Start a local app. Any app listening on a port works. For this example, create a Next.js app with npx create-next-app@latest and start it with npm run dev. It serves on http://localhost:3000.

2. Add a project and an app. Click Add project in the sidebar and give it a name. Then click Add App, name it my-app, and set the target to http://localhost:3000. LocalCan creates a local domain like https://my-app.local automatically.

3. Trust the root certificate. Open Settings and click Trust Certificate next to Root Certificate in the Local Domains section, then follow the prompts. This makes browsers accept HTTPS on your .local domains. Now open https://my-app.local and your app loads over HTTPS.

4. Share it with a Public URL. On the app's card, click Add Public URL and choose New Public URL. You get an address like https://my-app.localcan.dev that anyone can open.

Next steps

• Public URLs: pausing and resuming, custom domains, Snapshots, and access control.
• Local domains: how the proxy and mDNS advertising work.
• CLI quick start: the same flow from the terminal.