localghost¶

Localghost is a loopback-only Docker Compose proxy that gives local applications friendly .localhost URLs.

Quick start¶

Requirements: Docker Engine or Docker Desktop, Docker Compose 5.x (CI tests 5.1.4), uv, and loopback port 80 available.

Start the proxy:

uvx localghost

Open the dashboard at http://traefik.localhost. Stop it with:

uvx localghost down

Choose a workflow¶

For a Docker Compose application, generate the integration configuration:

uvx localghost generate

For a Django, Vite, or Astro server running directly on the host:

uvx localghost run

The framework is auto-detected. See Running host applications for the full workflow, custom ports, explicit framework selection, and Django runner resolution.

For the complete Compose contract, project naming, secondary services, and host-native workflows, see Integrate applications and Generate configuration.

Optional trusted HTTPS¶

HTTP is always available. To install Localghost's local development root and enable HTTPS, first install mkcert, then run:

uvx localghost trust

See Security and trust for certificate handling and Operations for lifecycle, status, ports, and upgrades.