VoltVaultInstall VoltVault

Self-hosted setup

Install VoltVault with Docker

Runs on macOS, Windows, Linux, and 64-bit Raspberry Pi. The installer downloads, verifies, and starts the server and browser app.

  1. 1

    Start Docker

    Install Docker Desktop for Mac or Windows. On Linux or Raspberry Pi, use Docker Engine with the Compose plugin. Wait until Docker is running. On Windows, use Linux containers.

    Linux and Raspberry Pi prerequisites

    The installer also needs Bash, curl, unzip, OpenSSL, and sha256sum or shasum. On Debian, Ubuntu, or Raspberry Pi OS, install the helper tools with:

    sudo apt-get install -y curl unzip openssl

    Docker must be running and accessible to your user. Check docker info if setup stops before the download.

  2. 2

    Run the installer

    On Mac or Linux, open Terminal and paste:

    curl -fsSL https://voltvaultapp.com/install.sh -o install-voltvault.sh && bash install-voltvault.sh

    Downloading the verified server and browser images can take several minutes. Leave Terminal open until the installer says VoltVault is ready. Read the script.

    Using Windows? See the PowerShell command below.

  3. 3

    Open localhost:8080

    Create your administrator account, then add a part, storage location, and starting stock.

Windows PowerShell

Run the Windows installer in PowerShell after Docker Desktop is ready.

Invoke-WebRequest -UseBasicParsing https://voltvaultapp.com/install.ps1 -OutFile "$env:TEMP\install-voltvault.ps1" if ($?) { powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\install-voltvault.ps1" }

Read the PowerShell script.

Use VoltVault from another device

After creating your administrator account, rerun the installer with this computer's private IP address. Keep it on your trusted LAN.

bash install-voltvault.sh --lan 192.168.1.20

Replace the example IP with your host's address. Read the LAN setup guide.

Troubleshooting

Port 8080 is already in use

Rerun the installer with --port 8081, then use the new address it prints.

Where is my data stored?

Installation files are in ~/voltvault. The database and uploads use persistent Docker volumes. Keep a protected backup of your .env file.

How do I connect a Bambu printer?

Once VoltVault is running, pair a supported printer under 3D printers. See the printer setup guide.