📦 Installation¶

versa is a single binary with no dependencies. Download it from the latest release:

OS	Architecture	File
Windows	x64	`versa_windows_amd64.exe`
Windows	ARM64	`versa_windows_arm64.exe`
Linux	x64	`versa_linux_amd64`
Linux	ARM64	`versa_linux_arm64`
macOS	Intel	`versa_darwin_amd64`
macOS	Apple Silicon (M1–M4)	`versa_darwin_arm64`

🪟 Windows¶

Download versa_windows_amd64.exe and rename it to versa.exe.
Put it in a folder, e.g. C:\versa.
Add that folder to PATH: search for "Edit the system environment variables" → Environment Variables → select Path → Edit → New → C:\versa.
Open a new terminal and check:

versa version

[!TIP] If you use pre_deploy_local hooks, also add Git's sh to PATH (C:\Program Files\Git\bin).

🐧 Linux and 🍎 macOS: one line¶

curl -fsSL https://raw.githubusercontent.com/kriollo/versaDeploy/main/install.sh | sh

Downloads the latest release for your OS and CPU, checks its sha256 against the release and installs it in /usr/local/bin (as root or when writable) or ~/.local/bin. VERSA_VERSION=v1.15.0 picks a version, VERSA_INSTALL_DIR=… the folder. Or by hand:

🐧 Linux¶

curl -L -o versa https://github.com/kriollo/versaDeploy/releases/latest/download/versa_linux_amd64
chmod +x versa
sudo mv versa /usr/local/bin/
versa version

🍎 macOS¶

# Apple Silicon; use versa_darwin_amd64 on Intel Macs
curl -L -o versa https://github.com/kriollo/versaDeploy/releases/latest/download/versa_darwin_arm64
chmod +x versa
sudo mv versa /usr/local/bin/
versa version

If macOS says the developer cannot be verified, allow it in System Settings → Privacy & Security, or run xattr -d com.apple.quarantine /usr/local/bin/versa.

🔄 Updating¶

versa self-update

Downloads the latest release for your platform and replaces the binary. It needs write access to the folder where versa is installed.

🛠 Building from source¶

Requires Go (see go.mod for the version).

git clone https://github.com/kriollo/versaDeploy.git
cd versaDeploy
go build -o versa ./cmd/versa          # versa.exe on Windows

Next step¶

Follow Getting Started to configure your first deploy.