Docs / System / Settings

Settings

Overview

System → Settings is the administrative home: application settings and appearance, admin user management, role assignment, and database backup. Most runtime behaviour is driven by environment variables (see Configuration); Settings shows the current effective config and helps you manage the pieces that live in the database.

Where things are

  • Application settings — global preferences and appearance (the app is dark by default with a light theme).
  • Effective configuration — a read-out of the current settings, with the ability to generate a starter .env.
  • Admin users & roles — create admin accounts and assign roles (see Roles).
  • Database backup — take a named snapshot of the database from the UI.

Common tasks

  • Generate a starter .env — Settings renders the effective config and can produce a .env you can drop onto a new host.
  • Back up before an upgrade — use Database Backup (or pg_dump) before running an upgrade.
  • Add another administrator — create the admin user and assign the right role.

Problems you may hit

  • A setting won't change in the UI — it's driven by an environment variable; edit .env and restart (see Configuration).
  • Backup fails — the backup directory (MONSTEROPS_BACKUP_DIR) isn't writable by the service user, or PostgreSQL tools aren't available on the host.
  • Only superadmin sees System — admin management, settings, and backups are superadmin-only.