Installation guide

The folder on Windows

Build the copy-and-run folder and start it on a Windows machine.

Building the folder

The folder is built on the development machine and copied as it is: the Windows machine that runs it installs nothing — no Rust, no Node, no Docker.

  1. From the root of the repository, run .\rebuild_bare_release.ps1 -NoSeedData: it assembles deploy\bare\out\ with the services as programs, Caddy, the portal and the apps, the configuration and the start and stop scripts.
  2. If SERVER_SECRETS.json exists at the root of the repository it travels in the folder, which then has to be kept secret; otherwise write the file on the target machine, or set the variables of the secrets before starting.
  3. Copy the out folder to the Windows 11 x64 machine, wherever you like.

Tip With -NoSeedData the folder holds an empty set of data; without it, a copy of the development machine's data, personal data included.

Starting the folder

Two scripts start and stop everything. The ports are chosen at every start: on a clean machine the gateway takes 8080 and the services the ports from 9001.

  1. In PowerShell, in the folder, run .\start.ps1: it starts the services and Caddy in the background, opens in the firewall the ports the gateway does not cover and waits until sign-in answers.
  2. .\start.ps1 --list prints what it would start and on which ports, without starting anything.
  3. Open https://localhost:8080/ on the machine itself, or its address on port 8080 from the local network.
  4. The certificate is the machine's own: the browser warns once — accept the warning, or run the start as administrator so that Caddy installs its certificate authority.
  5. .\stop.ps1 stops everything, on the ports the start really took.

Tip If another program holds a port, only that role moves to the next free port, and the start says so on screen.

Back to the guide

Productivity, made in Italy.

Bring the whole suite to your team — simple, secure and entirely yours.