Standalone Installation

There are two ways to install preq. Use standalone if you are detecting problems in non-Kubernetes environments.

Download

Download the latest release by selecting your operating system. No configuration is necessary to start using preq.

Linux (amd64)

Terminal:

wget https://github.com/prequel-dev/preq/releases/download/v0.1.25/preq-0.1.25-linux-amd64.tar.gz

Browser:

Linux (amd64)

Linux (arm64)

Terminal:

wget https://github.com/prequel-dev/preq/releases/download/v0.1.25/preq-0.1.25-linux-arm64.tar.gz

Browser:

Linux (arm64)

macOS (arm64)

Terminal:

curl -LO https://github.com/prequel-dev/preq/releases/download/v0.1.25/preq-0.1.25-darwin-arm64.tar.gz

Browser:

macOS (arm64)

Windows (amd64)

Terminal:

curl.exe -L -o preq-0.1.25-windows-amd64.tar.gz "https://github.com/prequel-dev/preq/releases/download/v0.1.25/preq-0.1.25-windows-amd64.tar.gz"

Browser:

Windows (amd64)

You can also view all available releases on GitHub.

Step 1: Unpack

Linux (amd64)

tar -zxvf preq-0.1.25-linux-amd64.tar.gz

Example output

preq-0.1.25-linux_amd64/
preq-0.1.25-linux_amd64/LICENSE
preq-0.1.25-linux_amd64/preq
preq-0.1.25-linux_amd64/preq.sha256
preq-0.1.25-linux_amd64/preq.sig

Linux (arm64)

tar -zxvf preq-0.1.25-linux-arm64.tar.gz

Example output

preq-0.1.25-linux_arm64/
preq-0.1.25-linux_arm64/LICENSE
preq-0.1.25-linux_arm64/preq
preq-0.1.25-linux_arm64/preq.sha256
preq-0.1.25-linux_arm64/preq.sig

macOS (arm64)

tar -zxvf preq-0.1.25-darwin-arm64.tar.gz

Example output

preq-0.1.25-darwin_arm64/
preq-0.1.25-darwin_arm64/LICENSE
preq-0.1.25-darwin_arm64/preq
preq-0.1.25-darwin_arm64/preq.sha256
preq-0.1.25-darwin_arm64/preq.sig

note

The macOS preq binary executable is also signed and notarized by Apple.

Windows (amd64)

tar -zxvf preq-0.1.25-windows-amd64.tar.gz

Example output

preq-0.1.25-windows_amd64/
preq-0.1.25-windows_amd64/LICENSE
preq-0.1.25-windows_amd64/preq
preq-0.1.25-windows_amd64/preq.sha256
preq-0.1.25-windows_amd64/preq.sig

Step 2: Install

Install preq to a location of your choosing. We recommend ~/local/bin.

Linux (amd64)

This command is written for bash. If you're using another shell, adjust as needed.

bash

mkdir -p ~/local/bin && cp ./preq-0.1.25-linux_amd64/preq ~/local/bin/preq
echo 'export PATH="$PATH:$HOME/local/bin"' >> ~/.bashrc

Linux (arm64)

This command is written for bash. If you're using another shell, adjust as needed.

bash

mkdir -p ~/local/bin && cp ./preq-0.1.25-linux_arm64/preq ~/local/bin/preq
echo 'export PATH="$PATH:$HOME/local/bin"' >> ~/.bashrc

macOS (arm64)

This command is written for zsh. If you're using another shell, adjust as needed.

zsh

mkdir -p ~/local/bin && cp ./preq-0.1.25-darwin_arm64/preq ~/local/bin/preq
echo 'export PATH="$PATH:$HOME/local/bin"' >> ~/.zshrc

Windows (amd64)

powershell

New-Item -Path "C:\Program Files\Preq" -ItemType Directory -Force
Copy-Item ".\preq-0.1.25-windows_amd64\preq.exe" -Destination "C:\Program Files\Preq\preq.exe"

Add C:\Program Files\Preq to your PATH (how?).

powershell

$preqPath = "C:\Program Files\Preq"; if ($env:Path -notlike "*$preqPath*") { $env:Path += ";$preqPath" }; $machinePath = [Environment]::GetEnvironmentVariable("Path", "Machine"); if ($machinePath -notlike "*$preqPath*") { [Environment]::SetEnvironmentVariable("Path", "$machinePath;$preqPath", "Machine") }

Run preq to verify the correct version is installed.

Linux (amd64)

This command is written for bash. If you're using another shell, adjust as needed.

bash

source ~/.bashrc && preq -v

Example output

preq 0.1.25 4b8f2eab0255686dad8b5d9ec7329024a5cbfb06 linux/amd64 2025-03-22

Learn more at https://docs.prequel.dev
Copyright 2025 Prequel Software, Inc. (https://prequel.dev)

Linux (arm64)

This command is written for bash. If you're using another shell, adjust as needed.

bash

source ~/.bashrc && preq -v

Example output

preq 0.1.25 4b8f2eab0255686dad8b5d9ec7329024a5cbfb06 linux/arm64 2025-03-22

Learn more at https://docs.prequel.dev
Copyright 2025 Prequel Software, Inc. (https://prequel.dev)

macOS (arm64)

This command is written for zsh. If you're using another shell, adjust as needed.

zsh

source ~/.zshrc && preq -v

Example output

preq 0.1.25 4b8f2eab0255686dad8b5d9ec7329024a5cbfb06 darwin/arm64 2025-03-21

Learn more at https://docs.prequel.dev
Copyright 2025 Prequel Software, Inc. (https://prequel.dev)

Windows (amd64)

preq.exe -v

Example output

preq 0.1.25 4b8f2eab0255686dad8b5d9ec7329024a5cbfb06 windows/amd64 2025-03-21

Learn more at https://docs.prequel.dev
Copyright 2025 Prequel Software, Inc. (https://prequel.dev)

Optional Step: Verify

All preq binaries and community rule package updates are hashed and signed.

To validate the sha256 hash:

Linux (amd64)

echo "$(cat preq-0.1.25-linux_amd64/preq.sha256)  preq-0.1.25-linux_amd64/preq" | sha256sum -c -

Example output

preq-0.1.25-linux_amd64/preq: OK

Linux (arm64)

echo "$(cat preq-0.1.25-linux_arm64/preq.sha256)  preq-0.1.25-linux_arm64/preq" | sha256sum -c -

Example output

preq-0.1.25-linux_arm64/preq: OK

macOS (arm64)

echo "$(cat preq-0.1.25-darwin_arm64/preq.sha256)  preq-0.1.25-darwin_arm64/preq" | sha256sum -c -

Example output

preq-0.1.25-darwin_arm64/preq: OK

Windows (amd64)

Get-FileHash .\preq-0.1.25-windows_amd64\preq.exe -Algorithm SHA256

Example output

Path
----
C:\Users\user\Downloads\preq-0.1.25-windows_amd64\preq.exe

Algorithm : SHA256
Hash      : 4B8F2EAB0255686DAD8B5D9EC7329024A5CBFB06
Path      : C:\Users\user\Downloads\preq-0.1.25-windows_amd64\preq.exe

Compare the output to the sha256 hash in preq.sha256.

To validate the ECDSA signature:

Linux (amd64)

echo '-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAErSs//3w6Db08czHrMIZY7oElDU2h
X8sOUQNRtOaNSmYh3XiNogV6+WdQ5kuZkz2R9qiEHXbzqACzkMsKV8E9iw==
-----END PUBLIC KEY-----' > pubkey.pem
openssl dgst -sha256 -verify pubkey.pem -signature preq-0.1.25-linux_amd64/preq.sig preq-0.1.25-linux_amd64/preq

Example output

Verified OK

Linux (arm64)

echo '-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAErSs//3w6Db08czHrMIZY7oElDU2h
X8sOUQNRtOaNSmYh3XiNogV6+WdQ5kuZkz2R9qiEHXbzqACzkMsKV8E9iw==
-----END PUBLIC KEY-----' > pubkey.pem
openssl dgst -sha256 -verify pubkey.pem -signature preq-0.1.25-linux_arm64/preq.sig preq-0.1.25-linux_arm64/preq

Example output

Verified OK

macOS (arm64)

echo '-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAErSs//3w6Db08czHrMIZY7oElDU2h
X8sOUQNRtOaNSmYh3XiNogV6+WdQ5kuZkz2R9qiEHXbzqACzkMsKV8E9iw==
-----END PUBLIC KEY-----' > pubkey.pem
openssl dgst -sha256 -verify pubkey.pem -signature preq-0.1.25-darwin_arm64/preq.sig preq-0.1.25-darwin_arm64/preq

The output should say

Verified OK

Windows (amd64)

If you don't already have it, install openssl using either chocolatey or scoop.

choco install openssl
Set-Content -Path pubkey.pem -Encoding ASCII -Value "-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAErSs//3w6Db08czHrMIZY7oElDU2h
X8sOUQNRtOaNSmYh3XiNogV6+WdQ5kuZkz2R9qiEHXbzqACzkMsKV8E9iw==
-----END PUBLIC KEY-----"
openssl dgst -sha256 -verify pubkey.pem -signature preq-0.1.25-windows_amd64\preq.sig preq-0.1.25-windows_amd64\preq.exe

Example output

Verified OK

kubectl (Krew)

Use the kubectl plugin if you are detecting problems in Kubernetes clusters.

Step 1: Install

Krew is the package manager for Kubernetes kubectl plugins. With Krew installed run:

kubectl krew install preq

Example output:

Updated the local copy of plugin index.
Installing plugin: preq
Installed plugin: preq
\
 | Use this plugin:
 | 	kubectl preq
 | Documentation:
 | 	https://github.com/prequel-dev/preq
/
WARNING: You installed plugin "preq" from the krew-index plugin repository.
   These plugins are not audited for security by the Krew maintainers.
   Run them at your own risk.

This will install preq as a kubectl plugin on any of the above supported operating systems and architectures. As with standalone preq, all binaries hashed and signed. And macOS binaries are also notarized and signed by Apple.

Optional Step: Verify

To validate the ECDSA signature:

Linux (amd64)

echo '-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAErSs//3w6Db08czHrMIZY7oElDU2h
X8sOUQNRtOaNSmYh3XiNogV6+WdQ5kuZkz2R9qiEHXbzqACzkMsKV8E9iw==
-----END PUBLIC KEY-----' > pubkey.pem
openssl dgst -sha256 -verify pubkey.pem -signature ~/.krew/store/preq/v0.1.25/kubectl-preq.sig ~/.krew/store/preq/v0.1.25/kubectl-preq

Example output

Verified OK

Linux (arm64)

echo '-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAErSs//3w6Db08czHrMIZY7oElDU2h
X8sOUQNRtOaNSmYh3XiNogV6+WdQ5kuZkz2R9qiEHXbzqACzkMsKV8E9iw==
-----END PUBLIC KEY-----' > pubkey.pem
openssl dgst -sha256 -verify pubkey.pem -signature ~/.krew/store/preq/v0.1.25/kubectl-preq.sig ~/.krew/store/preq/v0.1.25/kubectl-preq

Example output

Verified OK

macOS (arm64)

echo '-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAErSs//3w6Db08czHrMIZY7oElDU2h
X8sOUQNRtOaNSmYh3XiNogV6+WdQ5kuZkz2R9qiEHXbzqACzkMsKV8E9iw==
-----END PUBLIC KEY-----' > pubkey.pem
openssl dgst -sha256 -verify pubkey.pem -signature ~/.krew/store/preq/v0.1.25/kubectl-preq.sig ~/.krew/store/preq/v0.1.25/kubectl-preq

The output should say

Verified OK

Windows (amd64)

If you don't already have it, install openssl using either chocolatey or scoop.

choco install openssl
Set-Content -Path pubkey.pem -Encoding ASCII -Value "-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAErSs//3w6Db08czHrMIZY7oElDU2h
X8sOUQNRtOaNSmYh3XiNogV6+WdQ5kuZkz2R9qiEHXbzqACzkMsKV8E9iw==
-----END PUBLIC KEY-----"
openssl dgst -sha256 -verify pubkey.pem -signature $env:USERPROFILE\.krew/store/preq/v0.1.25/kubectl-preq.sig $env:USERPROFILE\.krew/store/preq/v0.1.25/kubectl-preq

Example output

Verified OK