localhost:

Changelog

What’s new in localhost

Every release, newest first. Downloads are on GitHub Releases.

v0.1.0

The first release, for macOS, Linux and Windows

The first version of localhost: a native SwiftUI app for macOS, and one app for Linux and Windows, all on one Rust core.

  • Projects and Services: one command line, working directory and environment per Service, run in your login shell (cmd.exe on Windows). Start, stop and restart one Service, or Start All / Stop All in dependency order.
  • Ports: a Service is Running once its Port accepts connections. A taken port says who holds it, and a Service can move to the next free one for a Run. The Ports view lists every Listener on the machine.
  • Environment: Project and Service variables, Environment Profiles and Secrets in the system’s secret store. “Restart to apply” when a running Service’s configuration changes.
  • Logs: each Service’s output with colours, the merged All services view, filter and clear, smooth with very chatty Services.
  • Stats: a running Service’s CPU and memory, sampled only while its popover is open.
  • Suggestions: Add Project scans the folder for Node scripts, Compose services, Python apps and Cargo binaries, for you to review.
  • Project files: export a Project to YAML and import it again.
  • Keyboard and accessibility: the command palette on ⌘K and Ctrl+K, a shortcut for every action, a Keyboard Shortcuts sheet on ⌘/ and Ctrl+/, screen readers, Reduce Motion and Reduce Transparency.
  • The menu bar companion and the tray, and Orphans offered to stop after a crash.
  • Linux: packaged as .deb, .rpm and AppImage.
  • Windows: a per-user installer. Services run with your user environment read fresh at each start, inside a Job Object, and stop with Ctrl-Break.
  • WSL: a Project can run inside a WSL distro, through a small localhostd the app copies into it. Commands, detection and the Ports view run in the distro.
  • The localhost command, on the same core and data: projects, status, logs and up.

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 →