Skip to content

Installation

import { Tabs, TabItem } from ‘@astrojs/starlight/components’;

portctl is distributed as standalone native binaries with zero external dependencies.

Section titled “1-Line Standalone Installers (Recommended)”
```bash curl -fsSL https://portctl.pages.dev/install.sh | sh ```

The installer will:

  • Auto-detect CPU architecture (Apple Silicon aarch64 or Intel x86_64, Linux x86_64).

  • Query the latest release tag from GitHub Releases.

  • Download the compressed archive and verify its SHA256 cryptographic checksum.

  • Install into /usr/local/bin (or $HOME/.local/bin if non-root).

Terminal window
irm https://portctl.pages.dev/install.ps1 | iex

The script will:

  • Download the latest Windows MSVC zip archive.

  • Verify SHA256 checksum.

  • Unpack into %LOCALAPPDATA%\Programs\portctl.

  • Automatically update both User and active session $env:PATH.

Terminal window
cargo install portctl-cli
```bash brew install tackelua/tap/portctl ```

If you prefer to download standalone executables directly without running scripts:

Platform Target Triple Direct Executable Download Checksum
macOS Apple Silicon aarch64-apple-darwin portctl-darwin-arm64 Checksum
macOS Intel x86_64-apple-darwin portctl-darwin-x86_64 Checksum
Linux (glibc) x86_64-unknown-linux-gnu portctl-linux-x86_64 Checksum
Windows x86_64-pc-windows-msvc portctl-windows-x86_64.exe Checksum

Generate auto-completions for your shell:

Terminal window
# Zsh
portctl completion zsh > ~/.zsh/completions/_portctl
# Bash
portctl completion bash > /etc/bash_completion.d/portctl
# Fish
portctl completion fish > ~/.config/fish/completions/portctl.fish