localhost:

Ports

When a Service is up, taken ports, and the Ports view.

A Service’s Port is the one TCP port it is expected to listen on. The command gets it as $PORT (%PORT% in cmd); localhost never rewrites command lines or adds framework flags.

When a Service is Running

With a Port, a Service counts as Running once the port accepts connections. After 30 seconds it is Running anyway, with a warning that clears when the port opens. Without a Port, it is Running after about 1.5 seconds alive.

When a port is taken

Before starting a Service with a Port, localhost checks who holds it. If something else does, the Service can start on the next free port (it gets that port as $PORT for this Run; the configured Port doesn’t change), or you choose: stop the other process and start, start on another port, or cancel.

Settings turns the automatic move off; a Service’s Port can change switch turns it off for that Service. A Service that others depend on never moves, and neither does one whose port is held by something in the same Project.

Open in Browser

Open in Browser (⇧⌘O) opens the Service’s URL with its port moved to the Run’s, or http://localhost:<port>, or else the first local URL the Run printed.

The Ports view

The Ports view (⌘0) lists every process listening on a TCP port and whom it belongs to: one of your Services, a process running inside one of your Projects’ folders, or nothing localhost knows (other apps and system services are folded below). Select one and press ⌘. to stop it; localhost asks first for anything it didn’t start.

Edit this page on GitHub

Install localhost for macOS

Two quick steps, usually under a minute.

  1. Drag it to Applications

    Open localhost-<version>.dmg and drag localhost to Applications.

    Download localhost-<version>.dmg
  2. Open it the first time

    localhost isn’t notarized by Apple yet, so macOS blocks the first launch once:

    1. Click Done in the warning.
    2. Open System Settings › Privacy & Security and scroll to Security.
    3. Click Open Anyway, and confirm with your password or Touch ID.

    Or run this in Terminal, then open localhost:

    xattr -dr com.apple.quarantine /Applications/localhost.app

macOS 15 or later · Apple silicon or Intel

  1. Run the installer

    Open localhost_<version>_x64-setup.exe. It installs for your user only, no administrator rights needed.

    Download localhost_<version>_x64-setup.exe
  2. Get past SmartScreen

    The installer isn’t signed by a known publisher yet, so Windows says “Windows protected your PC”:

    1. Click More info.
    2. Check that the file is localhost_<version>_x64-setup.exe.
    3. Click Run anyway.

Windows 10 or 11 · x64 · WSL 2 for Projects in WSL

  1. Download your package

  2. Install it

    From the folder you downloaded it to:

    sudo apt install ./localhost-app_<version>_amd64.deb
    sudo dnf install ./localhost-app-<version>-1.x86_64.rpm
    chmod +x localhost-app_<version>_amd64.AppImage && ./localhost-app_<version>_amd64.AppImage

    Secrets need a Secret Service (GNOME Keyring, KWallet). On stock GNOME the tray icon needs the AppIndicator extension.

x86_64 · Ubuntu 22.04+ · Debian 12+ · Fedora

On another system?Install guide →