bv-agent v1.0.0

Download the Backup Verified Agent

Install the agent on your server to securely back up your data and verify it remains intact and retrievable — without Backup Verified ever seeing your information.

Built for business professionals, small teams, and compliance-minded organizations.

Friendly note

The Backup Verified agent is free to download and configure. Running backups requires an active Backup Verified subscription. You can still prepare your system and validate your configuration locally before subscribing.

macOS (Apple Silicon)

Version 1.0.0 — arm64 build for modern macOS systems.

Download bv-agent-v1.0.0-darwin-arm64

If you downloaded the file manually

  • The file will usually land in your Downloads folder.
  • Move it into your system path so you can run bv-agent from anywhere:
sudo mv ~/Downloads/bv-agent-v1.0.0-darwin-arm64 /usr/local/bin/bv-agent
  • Make it executable:
sudo chmod +x /usr/local/bin/bv-agent
  • Confirm it is installed:
which bv-agent

Install from Terminal (recommended for servers)

sudo curl -L https://backupverified-agent.s3.amazonaws.com/macos/bv-agent-v1.0.0-darwin-arm64 \
  -o /usr/local/bin/bv-agent && sudo chmod +x /usr/local/bin/bv-agent

Then run: which bv-agent

Linux

Version 1.0.0 — choose the build that matches your server.

Download bv-agent-v1.0.0-linux-amd64 (x86_64)
Download bv-agent-v1.0.0-linux-arm64 (ARM64 / Graviton)

If you downloaded the file manually

  • Move the downloaded file into /usr/local/bin and rename it to bv-agent.
  • Use the command that matches the file you downloaded:
sudo mv ~/Downloads/bv-agent-v1.0.0-linux-amd64 /usr/local/bin/bv-agent
sudo mv ~/Downloads/bv-agent-v1.0.0-linux-arm64 /usr/local/bin/bv-agent
  • Make it executable:
sudo chmod +x /usr/local/bin/bv-agent
  • Confirm it is installed:
which bv-agent

Install from Terminal

Pick the command that matches your architecture.

# Linux x86_64 (amd64)
sudo curl -L https://backupverified-agent.s3.amazonaws.com/linux/bv-agent-v1.0.0-linux-amd64 \
  -o /usr/local/bin/bv-agent && sudo chmod +x /usr/local/bin/bv-agent
# Linux ARM64 (Graviton / arm64)
sudo curl -L https://backupverified-agent.s3.amazonaws.com/linux/bv-agent-v1.0.0-linux-arm64 \
  -o /usr/local/bin/bv-agent && sudo chmod +x /usr/local/bin/bv-agent

Then run: which bv-agent

FreeBSD

Version 1.0.0 — amd64 build for FreeBSD servers.

Download bv-agent-v1.0.0-freebsd-amd64

If you downloaded the file manually

  • The file will usually land in your Downloads folder.
  • Move it into /usr/local/bin and rename it to bv-agent:
sudo mv ~/Downloads/bv-agent-v1.0.0-freebsd-amd64 /usr/local/bin/bv-agent
  • Make it executable:
sudo chmod +x /usr/local/bin/bv-agent
  • Confirm it is installed:
which bv-agent

Install from Terminal

# FreeBSD (fetch is commonly available)
sudo fetch -o /usr/local/bin/bv-agent https://backupverified-agent.s3.amazonaws.com/freebsd/bv-agent-v1.0.0-freebsd-amd64
sudo chmod +x /usr/local/bin/bv-agent
# Or using curl (if installed)
sudo curl -L https://backupverified-agent.s3.amazonaws.com/freebsd/bv-agent-v1.0.0-freebsd-amd64 \
  -o /usr/local/bin/bv-agent && sudo chmod +x /usr/local/bin/bv-agent

Then run: which bv-agent

Verify Your Download

Download the SHA-256 checksums file to confirm the integrity of your binary.

Download checksums-v1.0.0.txt
shasum -a 256 bv-agent

Or run the checksum command against whichever filename you downloaded before renaming it.

Quick Start

# 1) Generate a client encryption key
bv-agent generate-key

# 2) Create or edit your config file
nano bv-agent.yml

# 3) Paste the generated value into client_encryption_key_b64
#    and paste your agent_key into the config file

# 4) Validate your config
bv-agent validate-config -config bv-agent.yml

# 5) Run your backup
bv-agent backup -config bv-agent.yml

Need help building your config file? See the documentation and recipes pages for working examples.

Keep your encryption key safe

Your backups are encrypted before upload. Backup Verified cannot read your data and cannot restore it if you lose your key. Store it securely.