Changelog

• UI — Paused endpoints now show a green pause icon instead of a crossed-out one.
• Request Inspector — Requests that fail with 502 because your local server is down now keep their request body, for both Public URLs and .local domains traffic.
• Reliability — Fixed Public URLs failing to connect is some cases, right after migrating from LocalCan 2.x.

This version ships with Daemon 1.0.0-beta.5

Still a beta. If you hit anything weird, drop a note at beta@localcan.com — feedback during the beta is genuinely valuable.

Fixes & improvements

• Fixed tunnels failing to connect with an older (v1) license key — the daemon now upgrades the key first and retries automatically.
• Request bodies are now captured when the target server is down (502), for both tunnels and local domains.
• Clearer error when your license doesn't cover current app version.

Still a beta. If you hit anything weird, drop a note at beta@localcan.com — feedback during the beta is genuinely valuable.

• UI — Sidebar has new updated UI
• Reliability — Improved startup recovery so the app replaces an older stuck daemon with the bundled current one.

This version ships with Daemon 1.0.0-beta.4

Still a beta. If you hit anything weird, drop a note at beta@localcan.com — feedback during the beta is genuinely valuable.

• Fixed an issue where tunnels and local domains could stop working after sleep/wake.
• Fixed restart cases where LocalCan could report port Proxy port already in use by localcan.
• Added extra diagnostics for sleep/wake issues.

Still a beta. If you hit anything weird, drop a note at beta@localcan.com — feedback during the beta is genuinely valuable.

Reliability

LocalCan no longer gets stuck on a "Not connected" error when its background service restarts, your machine sleeps and wakes, or the connection briefly drops. The app keeps retrying and reconnects on its own, then re-syncs your projects, proxy status, and inspected traffic once it's back.

Improvements

• Connecting screen — launch shows a clear "Starting LocalCan…" state, with Open logs and Retry if it stalls.
• Reconnecting badge — a brief "Reconnecting…" indicator appears while the app re-establishes its connection.
• No false activation prompts — a connection hiccup at launch is no longer mistaken for a lapsed license, so you won't be sent to the activation screen by mistake.

This version ships with Daemon 1.0.0-beta.3

Still a beta. If you hit anything weird, drop a note at beta@localcan.com — feedback during the beta is genuinely valuable.

Diagnostics

The daemon now leaves a clearer trail when something goes wrong:

• Connection logging — client connects and disconnects are logged with how they ended (a clean close vs a dropped socket), so a client that connects and then vanishes is no longer invisible.
• Slow-RPC warnings — a request handler that stalls is logged daemon-side instead of surfacing only as a client-side timeout.
• Richer localcan status — now reports daemon uptime and the number of connected clients.

Still a beta. If you hit anything weird, drop a note at beta@localcan.com — feedback during the beta is genuinely valuable.

Free mode

LocalCan now supprts Free mode for local-only development. It no longer quits when it can't find a license. The proxy, .local domains, and traffic inspection keep working — only Public URLs need an active license. If your license lapses or a trial ends, the app drops to free mode instead of shutting down.

Improvements

• .local domains default to HTTPS — new .local domains created in the app default to HTTPS instead of HTTP.
• Self-healing Public URLs — when a tunnel can't reach LocalCan you get a plain "Can't reach LocalCan. Check your internet connection." instead of a raw error, and it auto-retries so the connection recovers on its own once the network is back.
• Clearer custom-domain errors — 403s from a misconfigured custom domain are now explained in plain language.
• Improved traffic inspection — captured requests are filtered by the incoming host, not the rewritten Host header.

Fixes

• Fixed a UI freeze after sleep/wake caused by a stale daemon socket on reconnect.
• Refreshed app icons.

This version ships with Daemon 1.0.0-beta.2

Still a beta. If you hit anything weird, drop a note at beta@localcan.com — feedback during the beta is genuinely valuable.

Free mode

The daemon now stays running when there's no valid license instead of shutting down. The proxy, .local domains, mDNS, and traffic inspection keep working unlicensed — only tunnels are gated. localcan http and localcan https publish a .local endpoint in free mode (localcan tcp still needs a license), and standalone CLIs self-update without a license key.

Terms & telemetry

• First-run Terms consent — accept interactively, or non-interactively with localcan accept-terms or the global --accept-terms flag.
• Opt-in telemetry — usage data is off by default, and activating a license no longer turns it back on. Change it any time with localcan license set-usage-data <yes|no>.

Improvements

• --json quick tunnels — localcan http, https, and tcp can stream newline-delimited JSON (NDJSON) for scripting and automation.
• .local defaults to HTTPS — localcan http and localcan https create HTTPS .local endpoints, and quick tunnels serve .local on both HTTP and HTTPS (HTTP 301-redirects). Forwarding output is now scheme- and port-aware.
• Self-healing tunnels — connectivity failures to LocalCan are reported as a single plain-language error and retried on backoff, so a tunnel recovers on its own when the network returns. Fatal errors (tunnel limit, no domain) still need a manual retry.
• Friendlier list — a bare localcan list or localcan ls now guides you to the right command.

Fixes

• Quick tunnels no longer ignore Ctrl-C while still connecting.
• Leftover quick-tunnel config files are cleaned up after an abrupt exit (SIGKILL) and swept at daemon startup.
• Fixed a socket-removal race that could leave a freshly started daemon unreachable.

Still a beta. If you hit anything weird, drop a note at beta@localcan.com — feedback during the beta is genuinely valuable.

LocalCan 3.0.0-beta.1 🚀 (Beta)

Biggest update yet

LocalCan 3.0 Beta is the largest release we've ever shipped. Fully rewritten, with a daemon architecture, a global edge network, configuration as code, and a CLI bundled inside the desktop app.

Highlights for desktop users:

• Global edge network — Public URLs route through the closest edge data center instead of a single region. Faster page loads, snappier API responses, more consistent latency for verified custom domains.
• Configuration as code — your projects are now plain YAML files under ~/.localcan/projects/. Edit by hand, commit to git, hot-reload with localcan reload. The desktop UI reads and writes the same files.
• Multiple endpoints per service — one service can be reachable at a .local domain, a Public URL, and a custom domain at the same time. Each endpoint has its own headers and basic-auth rules.
• Bundled CLI — open Terminal from anywhere and run localcan http 3000. Same binary as the daemon, JSON output for automation and scripting, every flag documented.

Breaking changes

Cloudflare Quick Tunnel integration has been removed. If you used it in 2.x, switch to a Public URL on *.localcan.dev or a verified custom domain — both cover the same scenarios.

Upgrading from 2.x

3.0 installs alongside 2.x and leaves your existing data intact. On first launch, a dialog asks how much to migrate. The default ("license only") is reversible and recommended during the beta — your 2.x setup stays fully usable as a fallback.

Linux

Linux is now a supported platform, CLI-only for the moment. See the Installation guide.

Read the full announcement: LocalCan 3.0 Beta: The Biggest Update Yet.

This is a beta release. If you hit anything weird, drop a note at beta@localcan.com — feedback during the beta is genuinely valuable.

LocalCan CLI 1.0.0-beta.1 🐧 (Beta)

First public CLI release

This is the first publicly available LocalCan CLI. The same localcan binary ships bundled inside the macOS and Windows desktop apps and as a standalone build on Linux for the first time.

Highlights:

• Quick tunnels — localcan http <port>, localcan https <port>, and localcan tcp <port>. Live request log right in your terminal, Ctrl+C to stop.
• Daemon control — start, stop, restart, reload, status to manage the daemon from the command line.
• Resources — list loaded projects, services, and active tunnels with localcan projects ls, localcan services ls, localcan tunnel ls.
• License flow — localcan license activate <key> with --accept-terms / --no-usage-data flags for headless servers and CI.
• JSON output everywhere — every command supports --json for scripting, dotfiles automations, and AI agent integration.
• Linux native — runs on Linux x64 and arm64. One-line install:

Install: curl -fsSL https://localcan.com/install-beta.sh | sh

Linux notes

• .local mDNS resolution is not available on Linux today. Use system DNS, /etc/hosts, or a Public URL for sharing.
• Traffic inspection is desktop-only for the moment.
• localcan update handles binary updates on Linux. The desktop app's auto-updater takes over on macOS and Windows.

Read the full announcement: LocalCan 3.0 Beta: The Biggest Update Yet.

Quick start: CLI quick start. Reference: Commands and YAML configuration.

This is a beta release. Bug reports and feedback are welcome.

Team Members

Managing your team just got a whole lot easier! With LocalCan for Teams, you can now invite teammates directly from your dashboard and give them the right level of access:

• Admins – Can view all team members, invite and remove members, manage seat assignments, and view orders & invoices
• Members – Can use their assigned license to access LocalCan features

Seat Assignment

Easily manage your team's licenses by assigning members to available seats. No more headaches when someone leaves or you need to shuffle licenses around. Simply unassign a member from their seat, and the system automatically generates a fresh license key making sure access is revoked immediately.

Managing your dev team's LocalCan access is now straightforward. Head to your dashboard and start inviting people!

Migration to Stripe

We've migrated payments and subscriptions to Stripe. This means you can now view orders, manage your plan and seats directly from the dashboard.

Thank you for choosing LocalCan!

Announcing LocalCan version 2.7.0 🎉

Introducing TCP Tunnels (Beta)

This update brings an exciting new feature that opens lots of new possibilities for development and testing. TCP tunnels allow you to expose any TCP-based service running on your local machine to the internet.

What you can do with TCP tunnels:

• Database connections: Provide external access to PostgreSQL, MySQL, Redis, and other databases
• SSH Access: Securely connect to your development machine from anywhere
• gRPC Services: Test and share your gRPC APIs with remote clients
• Kubernetes Clusters: Expose local K8s services for remote development and debugging
• Custom TCP Applications: Support for any TCP-based protocol or service

TCP tunnels work seamlessly alongside existing HTTP tunnels, giving you complete flexibility in how you expose your local development environment to the world.

To create a TCP tunnel, click Add Domain in LocalCan, select Domain only and choose TCP as the protocol. When created, click Create Public URL similar as with HTTP tunnels.

Beta note: TCP tunnels use the new infrastructure based on QUIC protocol, which uses UDP instead of TCP. Make sure UDP traffic is not blocked by your firewall. As with any Beta, there might be some quirks. If you encounter any problems or have feedback, we'd love to hear from you – please reach out to support.

Enjoy the update!

This update includes:

• Fix an issue with the Pause option not showing for localcan.dev tunnels
• Fix the Show LocalCan menu bar item sometimes not working

Enjoy!

Announcing LocalCan version 2.6.0 🎉

Next-gen Public URLs (Beta)

This update is the first step towards new LocalCan tunneling infrastructure. Based on the modern QUIC protocol, tunnels provide up to 5x throughput, lower latency, and higher reliability, especially on unstable networks and with network changes.

While still in Beta, there might be some quirks. If you encounter any problems or have feedback, we'd love to hear from you – please reach out to support.

Future updates will bring TCP tunneling, multi-region edge servers for even better performance and Windows support.

Other Improvements

• macOS Tahoe support: The UI is now adjusted to support the Tahoe look and feel.

Enjoy the update!

This update resolves an issue in local domains where X-Forwarded-Host header was set to the modified Host instead of the original host.

Enjoy!

Announcing LocalCan version 2.5.0 🎉

This release brings a bunch of exciting improvements to the Traffic Inspector and beyond.

Inspect Traffic

• Image Previews: You can now view images directly in the request and response bodies.
• Brotli Decompression: Added support for displaying response bodies compressed with the Brotli algorithm.
• Performance Boost: Significantly improved memory management and performance, especially when dealing with large requests and responses.
• Auto-Select UX: Improved the user experience for the auto-select option.
• Stability: Fixed a crash that occurred under certain conditions.

Other Improvements

• Consistent Headers: The x-forwarded-* headers for local domains are now consistent with those used in Public URLs, ensuring uniform behavior.

Enjoy the update!

This update includes:

• Improved X-Forwarded-* headers by removing excessive proxy hops (multiple comma separated values e.g. X-Forwarded-Proto: https,http)
• Fix for Request Inspector showing an unmodified host header in WebSocket handshake request in LocalCan.dev tunnels

Enjoy!

This update fixes an issue where requests to the LocalCan Public URLs containing multipart/form-data with binary parts were not parsed correctly causing the request to fail with 400 Bad Request.

Enjoy!

Announcing LocalCan version 2.4.0 🎉

New Features

• Edit Domains: Instantly apply edits to your domains without recreating them.
• Edit Domain Groups: Personalize your domain groups with new name and icon customization options.
• Host Header Customization: Set the host headers for Public URLs and .local domains. Ideal for Laravel Herd users (See Guide: Using LocalCan with Laravel Herd Sites) or any context where host headers define served sites.
• Basic Auth for Public URLs: Protect your public app access with new Basic Authentication options for better privacy.
• Cloudflare Tunnels Improvements: Now featuring traffic inspection, customizable host headers, request replay, and Basic Auth.

Improvements

• Inspect Traffic Filter: Sort and analyze requests efficiently by filtering through methods, paths, and status codes.
• HTTPS→HTTPS Proxying: Useful if your existing app is already set up as https.

Plus, a dozen of under-the-hood improvements and optimizations.

Enjoy and thank you for choosing LocalCan!

In this release:

• Fixed a UI issue when displaying long Public URLs
• There is no error message appearing momentarily when creating a Cloudflare tunnel
• Resolved an issue where the "Show LocalCan" tray menu item had to be clicked twice to show the window

Enjoy!

This update fixes an issue where, in certain network configurations, wildcard subdomains didn't work. The reason was that mDNS was resolving to the wrong IP address of the host machine.

Enjoy!

Announcing LocalCan version 2.3.5 🎉

What's New

• Local domains reliability: Local domains now work smoothly after switching between Wi-Fi networks.

Improvements

• License Management: With the recently launched LocalCan™ Dashboard you can recover lost license keys and extend the allowed app updates period. There is new "I forgot my license key" option in the activation window, and an "Updates expired" badge will display if the license updates have expired.
• User Interface: App window now remembers its position between sessions.
• Menu Bar Icon: Added links for requesting features, reporting bugs, and Docs.
• Other: Under-the-hood improvements and optimizations.

Thank you for choosing LocalCan!

Announcing LocalCan version 2.3.4

What's New

• Custom Domains: Out of Beta: Custom domains are now a stable feature, with added support for multi-level custom domains e.g. api.local.example.co.uk. There is no limit to the number of levels, but the whole hostname should be a maximum of 256 characters.

Improvements

• Traffic Inspection: You can now clear all requests – it's easier to start debugging with a blank list.
• Sidebar: Proxy errors are now more visible, so you won't miss them.

Enjoy, and thank you for using LocalCan!

Automatic renewal of certificates for local domains

• 🔒 LocalCan now automatically handles the renewal process for certificates associated with local domains, ensuring uninterrupted secure connections.

Other improvements

• ⚡️ Improved performance and stability. Various optimizations and bug fixes have been implemented to improve the overall performance and stability.

Enjoy!

Fixing an issue when WebSockets could disconnect in Public URLs: 🌐

• The response timeout was increased further from 30 seconds to 5 minutes, as some WebSockets with ping intervals longer than 30 seconds could disconnect randomly.

Enjoy!

Improvements to Public URLs: 🌐

• Increased timeout for sending response to 30 seconds

• Responding with 504 Gateway Timeout when server response was not sent within 30 seconds

Enjoy!

Announcing LocalCan version 2.3.0 🎉

New feature: Custom domains in Public URLs 🌐

Boost branding and create more professional look of your Public URLs

• Add up to 2 custom domains
• Public URLs on a custom domain never expire
• Custom domain setup process takes 3 min
• Read more in Docs

Public URLs improvements

• Limit increase: we've increased the limit of Public URLs you can create from 3 to 5. More flexibility means more simultaneous live previews, making it easier to manage multiple aspects of your projects.
• Extended persistence: we understand the importance of longevity; thus, inactive Public URLs now persist for up to 5 days, up from the previous 1 day. This increase allows for more durable testing and sharing periods, giving your stakeholders more time to review and interact with your work.

Other improvements

• Connection tester: introducing a connection tester tool when adding a new domain. This addition checks if your target server is reachable, saving you time and eliminating the guesswork in troubleshooting connectivity issues.
• Better error messages: now, errors related to Public URLs, such as expiry notices or connectivity issues, are explicitly displayed inside its dropdown menu.

We're committed to making LocalCan the best tool for developers looking to share their local projects with the world. These updates are part of our ongoing efforts to respond to your feedback and improve your experience.

Grab a free 🟢 green-moonrise.heic wallpaper in 6K

Thank you for choosing LocalCan for your development needs!

Announcing LocalCan version 2.2.0 🎉

New Feature: 🃏 Wildcard subdomains for Local domains

This is a powerful feature, particularly for those working on multi-tenant applications.

What's New:

• Wildcard Subdomains: You can now publish domains in the format *.app.local. This feature enables a catch-all functionality for any subdomain requested under your primary domain.

Key Benefits:

• Flexibility: Manage multiple subdomains under a single wildcard domain. This feature is particularly useful for apps that have multiple microsites or services. You no longer need to add each subdomain individually.

• Simplified Development: Ideal for multi-tenant app development, where each tenant requires a unique subdomain.

Thank you for your support!

Improvements to Local domains: ✨

• Automatically redirect from http to https (when the http domain doesn't exist, but https does).

• Add the missing X-Forwarded-Host header on WebSocket upgrade requests.

• Fix WebSockets disconnecting randomly.

Enjoy!

New: Option to “Launch at Startup” ✨

• When turned on, LocalCan will launch silently on system startup, in Tray only mode

Updates in Inspecting Traffic

• Highlight new requests on the list, and fade them out after 2 seconds

• Fixed body display error when body was sent as incomplete

Enjoy!

Announcing LocalCan version 2.1.0 🎉

New Feature: 🚦 Inspect traffic from Local domains and Public URLs

• View requests and replies
• Replay requests (modify & replay feature coming soon)
• Prettify JSON and view decompressed payload (gzip, deflate)
• Display the request IP address
• Compact and condensed list layout
• Automatically select the newest requests
• Navigate using the keyboard
• No need for a target server to view requests

Updates to Local domains using reverse proxy:

• Potentially breaking change: The reverse proxy will now use local domain (e.g. app-name.local) to set the Host header, instead of using target server address for that (usually it was localhost or 127.0.0.1). This change aligns the behavior with Public URLs, which use the actual host address in the Host header.
• Local domains will respond with 502 Bad Gateway when the target server is not available. This change aims to maintain consistency in behaviors with Public URLs.

Thank you for your support!

Improvements to Public URLs on localcan.dev

• Improved reliability: Public URLs now automatically reconnect when occasional disconnections occur (e.g. internet connection lost).

• Enhanced error handling: In the case of a target server not responding, Public URLs will stay connected and display a 502 Bad Gateway error page.

Other improvements

• Added "Show what's new" button when new app version is available

• Refreshed app icon

Thank you for your support!

Announcing LocalCan version 2.0.0 🎉

🌐 Persistent Public URLs:

• Create up to three persistent & short Public URLs based on your project name
• Option to pause & resume URLs when not in use while keeping them reserved for one day

🖱️ Enhanced Tray Icon Menu:

• Quick access to local domains and Public URLs.
• Click on a domain to open it in the browser directly.

💅 Refreshed User Interface:

• Better look and responsiveness

Thank you for your support and amazing feedback!

New Feature: Public URLs The most requested feature is here! Share your work effortlessly with clients or stakeholders, test webhooks, OAuth, and more - all with just one click by creating a Public URL. This feature is provided by the free Cloudflare Tunnel service.

Thank you for your support!

New:

• Trial version!: you can now test LocalCan for 7 days before purchasing

Improvements:

• Extended port range to 65535
• Automatically prompt to trust RootCA after adding first HTTPS domain

Fixes:

• UI fixes

Thank you for your support!

This update adds full keyboard navigation to Add domain form. Enjoy!

This update enhances Reverse Proxy's handling of redirects, ensuring URL rewriting on 301/302/307/308 redirects. Enjoy!

Announcing LocalCan version 1.2.0 🎉

This update focuses on giving your more flexibility when using reverse proxy.

New Feature:

• Reverse Proxy custom target host: you can now specify any IP address or host name as a target server for a domain

Improvements to reverse proxy:

• Proxy changes the origin of the host header to the target server address
• Proxy follows redirects and rewrites the location host/port
• Proxy adds x-forward headers
• Updated links to Docs

Fixes:

• Subdomains now working when using https

Thank you for your support and amazing feedback!

Announcing LocalCan version 1.1.0 🎉 This update focuses on enhancing connection handling and making your experience more convenient. It introduces a powerful reverse proxy that makes secure connections truly effortless. Additionally, the proxy is capable of forwarding ports, eliminating the need for remembering them and allowing you to use just domain names instead.

New Features:

• Reverse Proxy: The new reverse proxy allows you to handle secure connections truly effortlessly. You no longer need to add generated certificates to your server configuration. Reverse proxy will establish secure connections for you and pass the request to your localhost server. Enjoy a simplified experience!
• Port Forwarding: Say goodbye to remembering port numbers. With the latest update, the proxy can now forward ports for you. Simply use domain names instead, making it easier than ever to manage your connections.

Thank you for your support and amazing feedback! Please use in-app feedback form to say what your think about this update or ask any questions you may have!

First release! 🎉🎉🎉