Overview

Initial Scaffolding

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

When to Use It

  • 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.

Behavior with firstRun=true

  • 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).

Typical Operations

  • 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).

After Provisioning

  • 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.

Screenshot

scaffolding-iniziale / install-main
scaffolding-iniziale / install-main