Ubuntu production

Check the host

The v1.0.0 installer accepts Ubuntu 24.04 or 25.04 amd64. This is an installer compatibility statement, not an OS lifecycle guarantee. Use 24.04 LTS for a fresh setup. Prepare sudo, DNS A/AAAA resolving from the host, inbound TCP 80/443 and free loopback port 3100. Back up existing services and test on staging first.

getent ahosts portal.example.com
uname -m
cat /etc/os-release

Install the latest stable release

Run the first command for the latest published stable release. The second pins the verified downloadable release; run only one. The bootstrap asks for the Portal domain, TLS email and initial password through your terminal, and requests sudo when needed. The Portal dashboard still requires a domain and HTTPS; an individual Web project can omit its domain in v1.0.0. The bootstrap verifies the archive SHA-256 before running its installer.

curl -fsSL https://dashboard-portal.cloud/install.sh | bash

curl -fsSL https://dashboard-portal.cloud/install.sh | bash -s -- --version v1.0.0

Download and verify

Run in Bash on the Ubuntu host. This block stops on errors. Only proceed when SHA-256 passes. A checksum verifies the downloaded archive against its release asset; signed updater verification is a separate step.

(
  set -eu
  REPO=raptercode/dashboard-portal-control
  TAG=v1.0.0
  VERSION=${TAG#v}
  mkdir "dashboard-portal-${VERSION}"
  cd "dashboard-portal-${VERSION}"
  curl -fSLO "https://github.com/${REPO}/releases/download/${TAG}/dashboard-portal-${VERSION}.tar.gz"
  curl -fSLO "https://github.com/${REPO}/releases/download/${TAG}/dashboard-portal-${VERSION}.tar.gz.sha256"
  sha256sum --check "dashboard-portal-${VERSION}.tar.gz.sha256"
  tar --extract --gzip --file "dashboard-portal-${VERSION}.tar.gz"
)

Run the installer

Replace the domain and email below. Choose --node-major=20/22/24/26 for Portal; default is 24. Enter the initial password interactively, not as a command argument.

cd dashboard-portal-1.0.0 &&
sudo bash ./dashboard-portal.sh --domain=portal.example.com --email=admin@example.com --node-major=24

The installer provisions the selected Portal Node major, Bun, Nginx, Certbot and Git. Native project Node versions are prepared when needed. Portal runs at 127.0.0.1:3100. Nginx serves HTTPS with HSTS. DNS/certificate failures fail installation rather than opening a public HTTP login. Docker is separate. Verify Go, Python venv, PHP and Composer readiness before deploying those runtimes; do not assume runtime support means its tools were installed.

Accept the real host

Replace portal.example.com here as well. Check API, web assets, login, a project deployment and rollback. Verify persistence after a planned reboot.

sudo systemctl is-active dashboard-portal hostmgr-deploy-helper nginx
sudo nginx -t
curl -fsS http://127.0.0.1:3100/api/health
curl -fsS https://portal.example.com/api/health
curl -fsSI https://portal.example.com/