Quick Start Guide

The five-minute version of the install. If anything below is unclear, read the full Installation Guide.

Prerequisites

• A freshly imaged Ubuntu 22.04+ or RHEL/Rocky/AlmaLinux 8+ host.
• Root or sudo access.
• Enough free disk space for /vault (anything ≥ the size of the cases you plan to keep online). A plain directory — no ZFS required.
• Your .lic file from the Customer Portal.

Steps

1. Install the package:

   sudo apt-get install ./sos-vault.deb     # Ubuntu/Debian
   sudo dnf install ./sos-vault.rpm         # RHEL/Rocky/AlmaLinux

2. Run the installer and follow the prompts:

   sudo /opt/sos-vault/sysadmin/installer.sh

3. When it finishes, open https://<host>/admin and sign in with the credentials you entered. As an admin you are prompted to enrol in TOTP 2FA — have an authenticator app ready to scan the QR code.
4. Go to Manage License and upload your .lic.
5. Add users and teams. You are live.

Want to rehearse first?

Run the installer with --dry-run. Every destructive verb is gated — you can walk every step without mutating the host.

sudo /opt/sos-vault/sysadmin/installer.sh --dry-run