> Install the Localport CLI on macOS, Linux, or Windows in under 30 seconds. One binary, zero dependencies. Homebrew, curl, or manual download.

# Installation

Localport is a single binary with zero dependencies. No runtime, no Docker, no package managers required. Download it and run it.

## Install the CLI

Run the command that corresponds to your operating system to install Localport:

**macOS**

Install via [Homebrew](https://brew.sh/):

```bash
brew install localport-dev/tap/localport
```

Or use the install script:

```bash
curl -fsSL https://get.localport.dev | sh
```

**Linux**

Install with the install script:

```bash
curl -fsSL https://get.localport.dev | sh
```

This detects your CPU architecture, downloads the correct binary, and places it in `/usr/local/bin`.

Or download manually from the [releases page](https://github.com/pvkas/localport/releases):

| Architecture | File |
|---|---|
| x86_64 | `localport-linux-amd64` |
| ARM64 (Raspberry Pi 4/5) | `localport-linux-arm64` |

```bash
chmod +x localport-*
sudo mv localport-* /usr/local/bin/localport
```

**Windows**

Download the binary from the [releases page](https://github.com/pvkas/localport/releases):

| Architecture | File |
|---|---|
| x86_64 | `localport-windows-amd64.exe` |

Move the downloaded `.exe` to a folder in your PATH, or add its location to your PATH environment variable.

## Verify the installation

```bash
localport --version
```

You should see the version number. If you get "command not found," make sure `/usr/local/bin` is in your PATH.

## Get a tunnel token

Before you can start a tunnel, you need a token:

1. Create an account at [dashboard.localport.io](https://dashboard.localport.io)
2. Create a team (or use the default one)
3. Go to **Tunnels** and create a new tunnel
4. Copy the token

You'll use this token every time you start a tunnel:

```bash
localport http 3000 --token YOUR_TOKEN
```

> [!TIP] Start with a free trial
> Localport has no free plan. Start a free trial — 30 days on Hobby or 7 days on Pro — with full HTTP, TCP, and TLS support (mTLS on Pro). See [pricing](/pricing) for plan details.

## Next steps

- [Quick Start](/docs/quick-start) — Your first tunnel in under 60 seconds
- [HTTP Tunnels](/docs/http-tunnels) — Share a web app with a public HTTPS URL
- [TCP Tunnels](/docs/tcp-tunnels) — Expose a database, game server, or SSH