Installation

Automated installer

The quickest way to install OpsVault is with the one-line installer. It downloads the binary, optionally installs pg_dump, mysqldump, and rclone, sets up the config, and installs the systemd service — all interactively.

curl -fsSL https://get.opsvault.dev | sudo bash

The installer will:

1. Download the correct binary for your architecture (amd64 or arm64)
2. Ask whether to install pg_dump, mysqldump, and rclone
3. Create /etc/opsvault/config.yaml if it doesn't exist
4. Ask whether to install OpsVault as a systemd service
5. Set up shell completions for bash, zsh, and fish

After the installer finishes, configure your databases with the wizard and run your first backup:

opsvault config wizard      # interactive TUI — add databases, storage, notifications
opsvault config validate    # confirm the config is valid
opsvault backup run         # run a test backup

Manual installation

Prefer to install step by step? Follow the sections below.

Requirements

Run opsvault doctor after installation to check which tools are missing.

Install the binary

Download the latest release for your architecture:

# x86_64 (most servers)
curl -L https://github.com/ArdaGnsrn/opsvault/releases/latest/download/opsvault-linux-amd64 \
  -o /usr/local/bin/opsvault

# ARM64 (e.g. Raspberry Pi, Oracle Ampere)
curl -L https://github.com/ArdaGnsrn/opsvault/releases/latest/download/opsvault-linux-arm64 \
  -o /usr/local/bin/opsvault

chmod +x /usr/local/bin/opsvault

Verify the installation:

opsvault version

Install database clients

# Debian / Ubuntu
apt-get install -y postgresql-client

# RHEL / Rocky / AlmaLinux
dnf install -y postgresql

# Debian / Ubuntu
apt-get install -y default-mysql-client

# RHEL / Rocky / AlmaLinux
dnf install -y mysql

Install rclone

rclone is required for remote storage uploads. Skip this if you only want local backups.

curl https://rclone.org/install.sh | sudo bash

After installing rclone, configure a remote:

rclone config

See the rclone setup guide for a step-by-step walkthrough.

Verify everything

opsvault doctor

Expected output when all tools are present:

Checking dependencies...

  ✓  pg_dump     /usr/bin/pg_dump
  ✓  mysqldump   /usr/bin/mysqldump
  ✓  rclone      /usr/bin/rclone

  All tools found. OpsVault is ready.

Uninstall

opsvault service uninstall   # remove systemd service
rm /usr/local/bin/opsvault
rm -rf /etc/opsvault