Settings

System-wide configuration including database backend and control plane settings.

Category: admin

Description

## Overview The Settings page exposes system-wide configuration for the DeltaForge deployment. Platform administrators use it to configure the catalog database backend (SQLite for single-node or PostgreSQL for multi-node deployments), establish the control plane connection parameters, and verify overall system health. Changes made here affect every component that reads configuration from the control plane. Because settings govern connectivity and storage, this page is typically the first destination during initial setup and the primary diagnostic surface when connectivity issues arise. ## Key Features - Configure the catalog database backend. Select between SQLite (embedded, suitable for development and single-node use) and PostgreSQL (recommended for production multi-node deployments). Provide connection strings, credentials, and pool size parameters. - Set control plane connection details including the listen address, port, TLS certificate paths, and authentication token. - Run on-demand health checks that verify connectivity to the catalog database, the licensing server, and all registered compute nodes. Results are displayed inline with pass/fail indicators and latency measurements. - View and edit general platform settings such as default workspace, session timeout duration, and log verbosity level. - Export the current configuration as a JSON snapshot for backup or migration purposes. ## Workflow 1. Navigate to Admin and select Settings. 2. During initial setup, configure the database backend first. Enter the connection string and test connectivity before saving. 3. Set the control plane listen address and TLS parameters. Restart the control plane service if the listen address or port changes. 4. Run a health check to confirm that the catalog database, licensing server, and compute nodes are all reachable. 5. Adjust general settings (session timeout, log level) as needed. 6. Save all changes. The control plane reloads configuration without requiring a full restart for most parameters.

See Also

Open in interactive docs →   DeltaForge home →