Installation

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.2/preq-0.1.2-linux-amd64.tar.gz

Browser:

Linux (amd64)

Linux (arm64)

Terminal:

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

Browser:

Linux (arm64)

macOS (arm64)

Terminal:

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

Browser:

macOS (arm64)

Windows (amd64)

Terminal:

curl.exe -L -o preq-0.1.2-windows-amd64.tar.gz "https://github.com/prequel-dev/preq/releases/download/v0.1.2/preq-0.1.2-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.2-linux-amd64.tar.gz

Example output

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

Linux (arm64)

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

Example output

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

macOS (arm64)

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

Example output

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

note

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

Windows (amd64)

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

Example output

preq-0.1.2-windows_amd64/
preq-0.1.2-windows_amd64/LICENSE
preq-0.1.2-windows_amd64/preq
preq-0.1.2-windows_amd64/preq.sha256
preq-0.1.2-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.2-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.2-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.2-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.2-windows_amd64\preq.exe" -Destination "C:\Program Files\Preq\preq.exe"

Add C:\Program Files\Preq to your PATH.

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.2 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.2 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.2 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.2 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.2-linux_amd64/preq.sha256)  preq-0.1.2-linux_amd64/preq" | sha256sum -c -

Example output

preq-0.1.2-linux_amd64/preq: OK

Linux (arm64)

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

Example output

preq-0.1.2-linux_arm64/preq: OK

macOS (arm64)

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

Example output

preq-0.1.2-darwin_arm64/preq: OK

Windows (amd64)

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

Example output

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

Algorithm : SHA256
Hash      : 4B8F2EAB0255686DAD8B5D9EC7329024A5CBFB06
Path      : C:\Users\user\Downloads\preq-0.1.2-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.2-linux_amd64/preq.sig preq-0.1.2-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.2-linux_arm64/preq.sig preq-0.1.2-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.2-darwin_arm64/preq.sig preq-0.1.2-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.2-windows_amd64\preq.sig preq-0.1.2-windows_amd64\preq.exe

Example output

Verified OK