localhost:

localhost vs foreman, overmind, honcho

foreman, overmind and honcho start a Procfile from one terminal. localhost gives each Service its own start, stop, Port readiness and log, in a window.

Procfile runners: one command starts every process listed in a Procfile, with their output in one terminal. Overmind runs each process in tmux, so you can attach to it.

Where foreman, overmind, honcho win

  • The Procfile is committed with the code, so the whole team starts the same processes.
  • They run anywhere a terminal does, including headless machines and SSH sessions.
  • The same Procfile format Heroku-style platforms read.

Where localhost fits better

  • Unlike foreman and honcho, start, stop or restart one Service from a window (Overmind can restart one process too, from the terminal).
  • Each Service is Running only once its Port accepts connections, and a taken Port says who holds it.
  • Nothing is written into your repository; export a Project file when you want to share one.

In one line

Choose foreman, overmind, honcho for
A shared Procfile in the repo, terminal and SSH workflows
Choose localhost for
Per-Service control, Port readiness and logs in a window

localhost is a free, open-source desktop app that runs your own commands, no Docker required, and isn’t a production or remote-server dashboard. Install it, start with the quick start, or read the guides.

Install localhost for macOS

Two quick steps, usually under a minute.

  1. Drag it to Applications

    Open localhost-0.3.0.dmg and drag localhost to Applications.

    Download localhost-0.3.0.dmg

    Or install it with Homebrew, which also puts the localhost command in your terminal:

    brew install --cask marcellosso/tap/localhost

    Or download it from Terminal, which macOS doesn’t block, so you can skip step 2:

    curl -fLO https://github.com/marcellosso/localhost/releases/download/v0.3.0/localhost-0.3.0.dmg && open localhost-0.3.0.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_0.3.0_x64-setup.exe. It installs for your user only, no administrator rights needed.

    Download localhost_0.3.0_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_0.3.0_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_0.3.0_amd64.deb
    sudo dnf install ./localhost-app-0.3.0-1.x86_64.rpm
    chmod +x localhost-app_0.3.0_amd64.AppImage && ./localhost-app_0.3.0_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 →