Installation

Requirements

• OS: Ubuntu 22.04+ or Debian 12+
• CPU: 1 vCPU (any architecture with Docker support)
• RAM: 512 MB minimum, 1 GB recommended
• Disk: 2 GB free
• Docker: 24.0 or newer
• Ports: 80 and 443 open for Traefik; 8443 for the Pier dashboard

Option A — one command (recommended)

curl -fsSL https://raw.githubusercontent.com/joveptesg/pier/main/scripts/setup.sh | sudo bash

This script installs Docker if missing, downloads the latest Pier binary, creates a pier system user, installs the systemd unit, and starts Pier on port 8443.

When it finishes, open https://YOUR_SERVER_IP:8443/setup to create your admin account.

Option B — build from source

git clone https://github.com/joveptesg/pier.git
cd pier
cargo build --release
sudo bash scripts/install.sh --binary target/release/pier

Requires a Rust 1.93+ toolchain. The resulting binary is around 15 MB once stripped.

Option C — Docker

docker run -d \
  --name pier \
  -p 8443:8443 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v pier-data:/app/data \
  ghcr.io/joveptesg/pier:latest

Docker is the fastest way to try Pier on a local machine. For production, prefer the native binary — it avoids the overhead of running Pier itself as a container.

After installation

1. Open https://YOUR_SERVER:8443/setup, create the admin account.
2. Add your first domain under Settings → Domains so Traefik can provision certificates.
3. Deploy a service from the one-click templates.

Uninstall

sudo systemctl stop pier
sudo systemctl disable pier
sudo rm -rf /opt/pier /etc/systemd/system/pier.service
sudo systemctl daemon-reload

This removes the binary, data directory, and systemd unit. Docker containers created by Pier are left alone — remove them separately if needed.