For business owners
- Keep ERP infrastructure under your control
- Use a repeatable deployment and update process
- Maintain backups and recovery paths
- Test changes in isolated Stage environments
- Run approved Soviez ERP releases—not a mutable “latest”
Official Soviez ERP deployment tool
Soviez.sh is the official deployment and lifecycle tool for self-hosted Soviez ERP. It handles installation, HTTPS, security baseline, tuning, backups, updates, and Stage environments—so you keep control of your infrastructure without assembling every operational layer by hand.
Install command
$ curl -fsSL https://soviez.sh | sudo bashRequires a supported Ubuntu LTS server (amd64) with sudo. Review the script before piping on production hosts. Next: check requirements, then run sudo soviez.sh --new to create Production. No GitHub account or permanent Docker Hub login required.
Prepare the host, authorize your license, select an approved ERP release, configure your domain and HTTPS, and bring Soviez ERP online through one supported workflow.
ERP runs on your server. Business databases, attachments, and accounting records stay with you. Soviez.sh manages deployment and lifecycle—not your ledger.
Firewall, TLS edge, private database exposure, non-root ERP runtime, and controlled image delivery—without requiring you to assemble the stack by hand.
Create recovery copies of database and filestore, restore when needed, and inspect installation health with status and diagnostics tools.
Soviez.sh adjusts runtime settings from available CPU and memory. Preview changes with a dry-run before applying them.
Create a separate copy of Production to test changes safely. Default Stage lifetime is 14 days (maximum 60 from creation). Entitlement expiry does not delete an existing Stage.
You own or control the server and domain. Your ERP business data stays on your infrastructure. Soviez authorization services verify license and release access for installation and updates—they do not host your accounting database. An existing ERP installation continues operating if Soviez services are temporarily unreachable.
Capacity planning
Production container / PostgreSQL sizing from concurrent users and transactional throughput—dedicated RAM, compute cores, and SSD with headroom—before you provision the host for soviez.sh.
Use this planner as a starting point for host capacity. After install, preview runtime sizing with soviez.sh --tune --dry-run.
$ soviez size --users 40 --tpm 80
RAM
7 GB
vCPU
4 vCPU
SSD
75 GB
Capacity plan: sized for 40 concurrent operators at 80 TPM — container/cgroup isolation, PostgreSQL buffers, and SSD headroom (automatic sizing).
RAM map: OS/Docker 1.0 GB · ERP runtime 4.0 GB · Postgres buffers 2.0 GB
Recommended cloud VMs
Recommendations are planning baselines. Heavy MRP, POS spikes, or large attachments may still need additional RAM / IOPS headroom.
Operator guide
Orientation for business owners and DevOps: requirements, install, day-to-day commands, Stage, backup, updates, and security. Full guides: soviez.com/docs.
01 — Prerequisites
Start from a supported Ubuntu server before piping the installer. You need root or sudo, a public hostname for Production, and enough CPU/RAM/disk for Docker, PostgreSQL, and ERP. Bare IP HTTP is not a supported Production edge—use a real domain. Details: requirements.
22.04 / 24.04 / 26.04 LTS amd64. Root or sudo required. arm64 is not supported.4+ vCPU and 8+ GiB RAM. Lab/light minimums are lower. Add headroom when Stages run concurrently. Use the calculator above for concurrent-user planning.80 / 443 and SSH on 22. Keep application and database ports private behind Nginx.Capacity map by concurrent operators (pair with the planner above). After install, preview sizing with soviez.sh --tune --dry-run.
| Concurrent users | vCPU | RAM | Notes |
|---|---|---|---|
| 1–15 | 2–4 vCPU | 4–8 GB | Lab / light Production |
| 16–40 | 4–8 vCPU | 8–16 GB | Growth + Stage headroom |
| 41–80 | 8–16 vCPU | 16–32 GB | High concurrency |
| 80+ | 16+ vCPU | 32 GB+ | Plan capacity carefully |
02 — Platform install
Run once per server. The public bootstrap installs soviez.sh on PATH (typically /usr/local/bin/soviez.sh). Then prepare the host with --init before creating Production. Full install guide: Quick Start.
curl -fsSL https://soviez.sh | sudo bashsudo soviez.sh --init prepares Docker, Nginx, firewall, and the security baseline.03 — Rapid deployment
From a clean supported Ubuntu host to Production: install Soviez.sh, prepare the host, point DNS at the server, then run --new. Guide: quick start.
curl -fsSL https://soviez.sh | sudo bash
# Prepare the host
sudo soviez.sh --init
# Create Production (domain, HTTPS, activation)
sudo soviez.sh --new
# Inspect
soviez.sh --list
soviez.sh --doctorhttps://soviez.sh.--init to prepare the host.erp.example.com) at the public IP, then run --new.443. Keep application and database ports private.04 — Operations
Use soviez.sh for host prep, Production, updates, Stage, backup, restore, and diagnostics. Migration uses the --migration-* family only.
# Inventory & health
soviez.sh --version
soviez.sh --list
soviez.sh --doctor
soviez.sh --operations
# Resource sizing (preview first)
soviez.sh --tune --dry-run
soviez.sh --tune --explain
# Backup
soviez.sh --backup <production-id>
soviez.sh --backup-list
# Update (approved release)
soviez.sh --update <production-id> --release <release-id>
# Stage (when entitled)
soviez.sh --stage --production-tenant <id> --stage-domain stage.example.com
soviez.sh --stage-list--init prepares the host; --new creates Production with domain, HTTPS, and activation.--list, --doctor, --operations, and --security-status.--update applies an approved ERP release—not a mutable latest tag. See updates.05 — Non-production
Stage is an isolated copy of Production for testing changes before they reach the live system. It uses a separate runtime, database, filestore, and hostname. Default lifetime is 14 calendar days, with a maximum of 60 days from original creation. Stage entitlement expiry blocks new Stage lifecycle operations—it does not automatically delete an existing Stage. Guide: Stage.
--stage-domain).# Create Stage from Production
soviez.sh --stage --production-tenant <id> --stage-domain stage.example.com
# Inventory & retention
soviez.sh --stage-list
soviez.sh --stage-retention-status
soviez.sh --stage-retention-extend <stage-id> --days N
# Operator teardown
soviez.sh --stage-drop <stage-id>06 — Health
Inspect installation health with local commands. If an operation cannot complete safely, Soviez.sh stops and reports the problem rather than forcing an unknown state. Full recovery guide: recovery.
soviez.sh --list
soviez.sh --doctor
soviez.sh --operations
soviez.sh --security-status
soviez.sh --ssl-status07 — Security
Soviez.sh applies a production-oriented security baseline—not a claim of absolute security. After --new, open your domain over HTTPS, sign in with the printed admin credentials, and complete activation if prompted. Guide: security.
22 / 80 / 443. ERP and PostgreSQL stay private behind Nginx.08 — Connectivity
Connected operations such as device authorization, new Production, product updates, and new Stage operations may require reachability to Soviez services.
Independence: an existing ERP installation continues operating if Soviez is temporarily unreachable. Support or update entitlement expiry does not stop ERP, block login, or delete business data—only covered support and future update access are affected. Local backup, restore, status, doctor, and recovery remain available. Details: FAQ.
09 — Data protection
Backups cover database, filestore, and required configuration/state. Restore returns an environment from a backup. Prefer off-host copies for stronger disaster-recovery posture. Guides: backup · restore.
soviez.sh --backup <production-id>
soviez.sh --backup-list
soviez.sh --backup-verify <backup-id>
soviez.sh --restore <production-id> --backup <backup-id> --confirm10 — Server moves
Move between Soviez hosts with the --migration-* command family (authorization, pairing, transfer, cutover, rollback). There is no single-flag migrate-in shortcut. Source cleanup is never automatic. Guide: migration.
11 — Releases
Soviez.sh securely retrieves approved Soviez ERP releases for your licensed installation. You do not need permanent Docker registry credentials on the server. Install and update use exact approved releases—not a mutable latest tag.
More detail: private image delivery.
12 — Next
Full operator documentation, FAQ, and troubleshooting live on soviez.com/docs. For commercial questions see pricing. For help: support.