Install System Integration Guide

The ngdpbase installation system runs a first-time setup wizard when the platform is first accessed. This guide describes what the installer does and what it creates. For the step-by-step walkthrough of completing the wizard, see Installation and First-Run Setup.

What the Installer Does

On first access, ngdpbase detects that setup is required and redirects you to the setup wizard (/install). The wizard:

Collects your application name, base URL, and organization details
Sets the administrator password
Copies Startup Pages into your pages directory (optional but recommended)
Writes your configuration and marks installation as complete

What Gets Created

Item	Description
`config/app-custom-config.json`	Your instance configuration — application name, base URL, session secret, organization details
`users/organizations.json`	Schema.org Organization record used in metadata and footers
Admin user	Administrator account with the password you set
Pages	All startup pages copied from `required-pages/` to your pages directory

After Installation

Once setup is complete the installer will not run again. You can:

Change your application name and other settings via Configuration Values or by editing app-custom-config.json directly
Update your organization details in users/organizations.json
Manage users via the admin panel

Developer Information

For implementation details, service layer architecture, and route integration, see Documentation for Developers.