Public site · installer and docs

VPS Deployer

Docs

Installation

The installer is https://vps-deployer.onebitstack.com/install.sh. It must run as root.

curl -fsSL https://vps-deployer.onebitstack.com/install.sh | sudo bash

Pin a version:

curl -fsSL https://vps-deployer.onebitstack.com/install.sh | sudo bash -s -- --version 0.8.1

Install from a local checkout:

sudo bash installer/install.sh --source /path/to/vps-deployer

What it does

  1. Detects OS, architecture, CPU, RAM, disk, and internet.
  2. Rejects unsupported systems.
  3. Installs git, Python, uv, nginx, and certbot.
  4. Creates the vps-deployer system user.
  5. Installs the application under /opt/vps-deployer.
  6. Preserves existing config and the SQLite database.
  7. Installs the CLI, privileged helper, sudoers snippet, and systemd unit.
  8. Starts vps-deployer.service and checks /health.

A second run is safe. It must not delete /var/www/apps, nginx site files, application units, or the database. If the new platform files fail health checks, the installer restores the previous /opt/vps-deployer/app, CLI, helper, and systemd unit.

Layout

PathPurpose
/opt/vps-deployerInstalled application
/etc/vps-deployerConfig directory (root:vps-deployer 770; config.env mode 640)
/var/lib/vps-deployerSQLite database
/var/log/vps-deployerInstaller and API logs
/var/www/appsYour applications
/usr/local/bin/vps-deployerCLI
/usr/local/libexec/vps-deployer-helperPrivileged helper

After install

vps-deployer doctor
systemctl status vps-deployer

Log: /var/log/vps-deployer/installer.log.

This website distributes the installer and documentation. It does not register your VPS, store credentials, or run deployments.

After install, your VPS keeps working if this site is down. Changelog