InstallationOverview
Overview
How self-hosted installation works (two-stage bootstrap).
eQuantic Space is a self-hosted appliance: you point a clean VPS at it and get the entire platform (CI/CD, registry, Deploy, web app).
Why two stages
A bare VPS has no runtime to serve the setup wizard — which is the web app itself. That's why installation happens in two stages: a minimal bootstrap on the host and then the wizard (which provisions everything else).
| Layer | What it does | Where it runs |
|---|---|---|
1. Bootstrap (install.sh) | Downloads a portable Node + the standalone bundles and brings the servers up on plain Node. Installs nothing on the host. | host (root) |
| 2. Setup-mode app | Runs stateless (no Postgres/Redis), serves the wizard and collects inputs in memory. | bootstrap's Node processes |
| 3. Provisioning engine | Installs Docker/k3s, ingress, TLS, in-cluster Postgres & Redis, registry, runners and the serverless runtime; brings up the final api/web. | host → k3s |
install.sh runs as root (you invoke it with sudo). This is required for the engine to install k3s and write the systemd units.