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
- Detects OS, architecture, CPU, RAM, disk, and internet.
- Rejects unsupported systems.
- Installs git, Python, uv, nginx, and certbot.
- Creates the
vps-deployersystem user. - Installs the application under
/opt/vps-deployer. - Preserves existing config and the SQLite database.
- Installs the CLI, privileged helper, sudoers snippet, and systemd unit.
- Starts
vps-deployer.serviceand 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
| Path | Purpose |
|---|---|
/opt/vps-deployer | Installed application |
/etc/vps-deployer | Config directory (root:vps-deployer 770; config.env mode 640) |
/var/lib/vps-deployer | SQLite database |
/var/log/vps-deployer | Installer and API logs |
/var/www/apps | Your applications |
/usr/local/bin/vps-deployer | CLI |
/usr/local/libexec/vps-deployer-helper | Privileged helper |
After install
vps-deployer doctor
systemctl status vps-deployer
Log: /var/log/vps-deployer/installer.log.