Local evaluation

Requirements

For Docker evaluation, install Docker Engine and Docker Compose. For a direct UI demo, install Node.js 24.x. Portal uses Node built-ins and does not need npm install for its own source.

Docker Compose sandbox

git clone https://github.com/raptercode/dashboard-portal-control
cd dashboard-portal-control
cp .env.example .env
openssl rand -base64 32
# Edit .env: set HOSTMGR_ADMIN_PASSWORD and HOSTMGR_SECRET_KEY.
docker compose up --build -d
docker compose ps
docker compose logs -f hostmgr

Open http://localhost. The Compose volume retains demo state. To deliberately remove it, run docker compose down -v; this destroys local sandbox data.

Direct Node demo

cp .env.example .env
# Edit the password and secret key as above.
npm run demo

Open http://127.0.0.1:3000. The supplied example uses HOSTMGR_SANDBOX_CLONE=false, which keeps project sync/deploy simulated for UI exploration. Set it to true or remove the line to exercise local clone/build/health-check work.

Reset a local demo password

npm run demo:reset-password

This works only in demo mode. It preserves demo state, prints a newly generated password once, and invalidates existing sessions.