Overview

Initial Scaffolding

This page describes the initial bootstrap when AppSettings.firstRun = true.

The scaffolding this page is about — reading the tables of a database and registering them in

_metadati__tabelle / _metadati__colonne — applies only to the "Existing database" mode of

the first-run wizard: that is where the *Scaffold the tables of the selected database

automatically* checkbox lives.

In tutorial packages that checkbox does not exist. The metadata database arrives already

populated (routes, columns, menu, translations, sample dashboards) and the wizard only restores

it and creates the admin user. Seeing ready-made routes right after the first start is therefore

not the result of scaffolding: it is the content of the tutorial.

Wizard mode	What happens to the metadata
Tutorial WideWorldImporters	Metadata already built, restored from the package. No scaffolding at all.
Existing database, checkbox off	An empty metadata database: you register the routes yourself, by hand or later from the Scaffolding page.
Existing database, checkbox on	At the end of the installation every table of the chosen database is registered as a route.

The rest of this page applies to the last two rows of that table.

New installation (metadata/data DB not yet ready).
Local environment to realign with initial setup.
First launch after deploy where you want to force the guided provisioning procedure.

The GET /api/Meta/FirstRunStatus endpoint exposes firstRun: true.
At login, the first run flow appears (e.g., Update action on the screen).
The setup applies base configurations (connections, runtime settings, metadata bootstrap).

Verify AppSettings.firstRun is true in appsettings.{Environment}.json of the host you are running.
Start the application and complete the initial scaffolding procedure from the UI.
Check that connections and main parameters are consistent (dbms, DataDBName, ConnectionStrings).

The setup procedure sets firstRun to false to avoid re-executions on each start.
Perform a standard login and validate access to the main routes.
With firstRun = false the wizard methods (e.g. configure_wuic) answer only administrators.
Oracle installations and MySQL installations with the tutorial created with packages up to 1.7.12: the first-run scripts contained the e2e test users (wuic_e2e_admin*, guest_1), which must not exist in production. Check the utenti table and delete or disable those users; since 1.7.13 the scripts no longer contain them.