Skip to content
This repository was archived by the owner on Jul 17, 2026. It is now read-only.

install.md

Latest commit

 

History

History
104 lines (68 loc) · 3.19 KB

install.md

File metadata and controls

104 lines (68 loc) · 3.19 KB
Raw

Install

Pier ships as a single self-contained binary. There is no runtime to install and no IDE dependency.

Supported platforms

OS Architectures
macOS 12+ Apple Silicon (arm64), Intel (x86_64)
Linux x86_64, arm64 (aarch64); glibc-based
Windows 10+ x86_64

Recommended: 8 GB RAM (4 GB minimum).

Install script (recommended)

macOS and Linux

curl -fsSL https://dl.piercode.com/stable/install.sh | sh

The script detects your OS and architecture, downloads the matching binary, verifies its SHA-256 checksum, installs it to ~/.pier/bin, and adds that directory to your PATH.

Windows

install.sh can't run natively on Windows, so use the PowerShell installer instead:

irm https://dl.piercode.com/install.ps1 | iex

It downloads the matching binary, verifies its checksum, installs pier under ~/.pier, and adds it to your PATH. Unsigned builds may trip a one-time Windows SmartScreen warning — choose More info → Run anyway.

Pin a version

macOS and Linux:

curl -fsSL https://dl.piercode.com/stable/install.sh | sh -s -- --release 0.4.0

Environment variables

The installer honors these:

Variable Default Purpose
PIER_RELEASE latest Version to install (overridden by --release).
PIER_INSTALL_DIR ~/.pier/bin Install directory.
PIER_NON_INTERACTIVE false Set to 1 to skip prompts (useful in CI).
PIER_BASE_URL the distribution domain Override the download base URL.

Manual download

Release artifacts are published per target at:

https://dl.piercode.com/v<version>/pier-<target>.tar.gz
https://dl.piercode.com/latest/pier-<target>.tar.gz

where <target> is one of:

  • aarch64-apple-darwin (macOS, Apple Silicon)
  • x86_64-apple-darwin (macOS, Intel)
  • aarch64-unknown-linux-gnu (Linux, arm64)
  • x86_64-unknown-linux-gnu (Linux, x86_64)
  • x86_64-pc-windows-msvc (Windows, x64)

Each tarball has a matching .sha256 sidecar and contains the pier binary (plus its helper executables on Windows). Extract it onto your PATH (substitute the target for your platform):

tar -xzf pier-aarch64-apple-darwin.tar.gz
mv pier ~/.local/bin/

Verify

pier --version

Update

Re-run the install script for your platform — it always fetches the latest published version (or pass --release for a specific one). You can also run pier update from an installed CLI.

Uninstall

macOS and Linux:

rm -rf ~/.pier

Then remove the # >>> Pier installer >>> block the installer added to your shell profile (~/.zprofile, ~/.bashrc, ~/.profile, etc.).

Windows (PowerShell):

Remove-Item -Recurse -Force "$HOME\.pier"

Then remove the ~/.pier/bin entry the installer added to your user PATH.