Reference

Preview

During Public Preview you can use the Team plan for free, and get an early-adopter discount at GA. Sign in

The reference section covers the bits of Locally you'll dip into rather than read cover-to-cover - installing and setting Locally up, component names, ports, supported regions, troubleshooting steps and frequently asked questions.

Every locally command with its synopsis, usage and flags, generated from the CLI's own help output.

The services that make up Locally - the Control Plane, the Locally Dashboard, Authorization, the Directory (Entra) Emulator and the Data Plane Emulators.

Add a Deploy to Locally button to your README, so anyone running Locally can open your ARM template in the Locally Dashboard with one click.

The feature flags you can turn on and off in Locally, what each one does and which plan it needs.

Common questions about Locally - why it's a custom environment and offline use.

The Locally-specific terms the documentation uses, from Automatic Configuration to Seeded and Session.

What locally setup does - local CA, DNS resolution, plugin install and Docker validation, with safe re-runs.

The Azure locations and regions you can provision resources into when using Locally.

How Locally configures your machine - trusting its CA, resolving *.locally on your machine and in containers, and what locally run sets - and how to undo it.

Every port Locally listens on and which interface it binds, how containers reach Locally, and what to do about HTTP proxies, VPNs and corporate DNS.

Override or extend the VM images, VM SKUs, extension types and app stacks Locally knows about, pulling them from Azure with locally refresh-reference-data.

How to report a bug, request a feature or report a security issue in Locally.

What a machine needs to run Locally - supported operating systems and architectures, permissions, ports, outbound endpoints and container runtimes.

What Locally listens on and for whom, what leaves your machine, every field in the opt-in crash reports and analytics, retention, and how to turn each off.

Diagnose and fix common issues when running Locally - locally validate, macOS notarisation and more.

How to update the Locally CLI and its plugins, and how to remove Locally completely - the binary, config, resolver rule and trusted root certificate.

Preview

During Public Preview you can use the Team plan for free, and get an early-adopter discount at GA. Sign in

A local cloud for you and your AI agents.

Your Azure infrastructure, running on your machine. Deploy in seconds, break things freely, and ship to Azure when you're ready.