localghost

Localghost gives local servers friendly .localhost URLs instead of port numbers:

https://storefront.localhost
https://admin.storefront.localhost
https://blog.localhost

Just a single local proxy routing all your development apps by hostname.

          ▒█████████████▒
        ███▒           ▒███░
      ▓██░               ░███           ██                          ██
     ██▒                   ▒██          ██░                         ██░
    ▓█▒                     ░██         ██░ ░█████░  ▒█████  █████▓ ██░
   ░██    ███▓       ████    ▓█▒        ██░░██   ██░▒█▓     ██░ ░█▓ ██░
   ██░    ███▓       ▓███    ░██        ██░░██░  ██░▒██     ██▒ ░█▓ ██░
   ██░         █   █          ██        ██░ ░█████░  ░█████  █████▓ ██░
   ██░         ▒███▒          ██░
   ██                         ██░            ░▒▒                       ░
   ██                 ▓█████████▒            ░▒▒                      ▒▒
   ██              ▓██▒▒▒▒▒▒▒▒██▒    ░▒▒▒▒▒▒ ░▒▒▒▒▒▒░  ▒▒▒▒▒░ ░▒▒▒▒░ ▒▒▒▒▒
  ░██░          ░██▓▒▒▒▒▒▒▒▒▒▒▒██   ░▒▒   ▒▒ ░▒▒  ░▒░ ▒▒░  ░▒░ ░▒░    ▒▒
  ▒████▓     ▒███▒▒▒▒▒▒▒▒▒▒▒▒▒▒██   ░▒▒   ▒▒ ░▒▒  ░▒▒ ▒▒░  ░▒░    ░▒░ ▒▒░
  ██▒▒▒▒▓▓█▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██░    ▒▒▒▒▒▒ ░▒▒  ░▒▒  ░▒▒▒▒░ ░▒▒▒▒░  ░▒▒▒
 ░██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒██  ░▒   ░▒▒
 ░██▒▒▒▒███████▓▒▒▒▒███████▒▒▒▒▒██    ░▒▒▒
  ▒█████▓     ▒█████▓     ▒██████

This is local-development infrastructure, not a production proxy. It runs a single, loopback-only Traefik proxy as the localghost Compose project on the shared localghost Docker network.

Quick start

You need Docker Engine or Docker Desktop, Docker Compose 5.x+, uv, and port 80 available. Start the proxy without cloning this repository:

uvx localghost

Open http://traefik.localhost for the dashboard. The command creates or reconciles the proxy and waits for it to become healthy. When it is already running, it lists active routes and their sources. To stop and remove it later, run:

uvx localghost down

To inspect its state without starting or reconciling it, run:

uvx localghost --status

Running local apps

localghost run detects Django, Vite, and Astro projects and serves them behind the proxy with zero configuration:

cd my-project
uvx localghost run

The app is available at https://my-project.localhost (or http:// if HTTPS is not configured). Press Ctrl+C to stop it.

Documentation

The localghost documentation covers application integration, generation, host-native servers, HTTPS, operations, troubleshooting, security, architecture, and development.

For a local documentation preview, install the development dependencies and run uv run zensical serve.

Metadata

Release files for localghost 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for localghost 1.2.0
File	Size	Uploaded
localghost-1.2.0.tar.gz	55.9 kB	Aug 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for localghost 1.2.0
File	Interpreter	ABI	Platform	Reset
localghost-1.2.0-py3-none-any.whl 77.1 kB Aug 17, 2026	Python 3	none	any	Details

Total release size: 133.0 kB

Release files / localghost-1.2.0.tar.gz

Download URL	localghost-1.2.0.tar.gz
Size	55.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`d94cd9dee5043cf7ac1a0bbd334260a0f0ecae1eccd665128097d603929d4879`
BLAKE2b-256 checksum How to use checksums	`2354095599e02bea8ee4478c4d7f83a4a22cd0d132fc4c36c7841c2ae64cd252`
Upload date	Aug 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / localghost-1.2.0-py3-none-any.whl

Download URL	localghost-1.2.0-py3-none-any.whl
Size	77.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`655e9d235e4a02241f50b2ecd7d4c2c27dedb85058e5f8c6ddb982cb0e4bb1b5`
BLAKE2b-256 checksum How to use checksums	`8c266b8b72af413230efd6cc8ca5ad0c899695a80c5db8349dfe37fddfe8bf95`
Upload date	Aug 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`