Skip to content
Zenso Logozenso.inkDocs

Cold-Boot Setup Wizard

When a new Zenso instance starts for the first time, it enforces a cryptographic bootstrap protocol to prevent unauthorized claiming.

Locating the Setup Token

Section titled “Locating the Setup Token”

Inspect the container logs of the API container to retrieve the generated single-use token:

Terminal window
docker compose logs zenso-api | grep "SETUP TOKEN"

You will see an entry similar to: ZENSO_SETUP_TOKEN: zenso_sec_9f81a7b...

Running the Setup Wizard

Section titled “Running the Setup Wizard”

Open your web browser and navigate to:

http://<SERVER_IP>:8080/setup

Paste your setup token and click Verify Instance.

Creating the Instance Owner Account

Section titled “Creating the Instance Owner Account”

Specify the administrator email and a strong password. Once submitted, the token is permanently invalidated, and you are logged into your sovereign Zenso dashboard.