localhost:

Environment and Secrets

Variables on Projects, Services and Environment Profiles, and Secrets.

Edit Environment… (in the Project’s menu) holds the Project’s variables and its Environment Profiles; each Service’s own variables are in its editor.

Layers

A Service gets, later ones winning:

  1. your login shell’s environment (on Windows, your user environment as a new sign-in would see it),
  2. the Project’s variables,
  3. the Service’s variables,
  4. the active Environment Profile’s variables (picked in the Project’s toolbar),

plus PORT when it has a Port, and FORCE_COLOR=1, CLICOLOR_FORCE=1, PYTHONUNBUFFERED=1 so tools keep their colours and don’t buffer output.

Secrets

Click the lock next to a variable to make it a Secret: its value goes to your system’s secret store and stays hidden until you click the eye. Secret values are never written to configuration files, logs or Project files.

Secret store
macOS login Keychain (see macOS)
Linux the Secret Service: GNOME Keyring, KWallet, KeePassXC (see Linux)
Windows Credential Manager

Changes apply the next time a Service starts; a running Service shows “Restart to apply”.

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 →