Installation

Installation

Important

Do not use go install to install PrivUtil. Because this project relies on a complex build process to embed web assets, standard go install is not supported and will fail. Please use the methods below.

Prerequisites

Requirement	Version	Notes
Go	1.21+	For building from source
Node.js	18+	For frontend development
Make	Any	Build automation

Option 1: Download Binary (Recommended)

🐧 Linux

1. Download privutil-linux-amd64.tar.gz (or arm64).
2. Extract and run:

   tar -xzf privutil-linux-amd64.tar.gz
   chmod +x privutil
   ./privutil

🍎 macOS

1. Download privutil-darwin-arm64.tar.gz (Apple Silicon) or amd64 (Intel).
2. Extract and run:

   tar -xzf privutil-darwin-arm64.tar.gz
   chmod +x privutil
   ./privutil

   Note: You may need to allow the app in System Settings > Privacy & Security.

🪟 Windows

1. Download privutil-windows-amd64.zip.
2. Right-click the file and select Extract All....
3. Double-click privutil.exe to start.

Option 2: Build from Source

# Clone repository
git clone https://github.com/odinnordico/privutil.git
cd privutil

# Build everything
make build

# Run
./privutil

Verify Installation

./privutil --version
# PrivUtil dev (built unknown)

./privutil --help
# Shows all available options

Next Steps

• Quick Start - Get up and running in 5 minutes
• Configuration - Customize your setup