1 control panel config and secret persistence
forgejo-actions edited this page 2026-07-13 19:45:35 +00:00

Control Panel Config And Secret Persistence

Control Panel config persistence stores service definitions, shared database and Redis settings, per-service env, and redacted secrets for local operations.

Purpose

Use this page when control-panel.json is malformed, secrets appear as placeholders, UPnP or internal-auth defaults upgrade unexpectedly, or services start with the wrong env.

Required Inputs

The panel config includes top-level shared database and Redis settings, service configs, env vars, secret placeholders, and upgradeable defaults. Runtime service launches resolve redacted secrets from real process env when possible.

Procedure

Let the panel generate defaults, then edit through panel UI where possible. Persist placeholders for secrets, not real secret values. Keep shared connection settings at the shared layer unless a service intentionally overrides them.

Failure Modes

Malformed JSON, duplicate env keys, empty secrets, missing URLs, stale UPnP defaults, and internal-auth placeholder drift can make service launch fail or silently use old values.

Verification

Run panel diagnostics after config edits. Confirm persisted env is sanitized, runtime env resolves real secrets, and generated defaults upgrade without overwriting intentional service-specific values.