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.envyou 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
.envand 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.
Related¶
- Configuration — the environment variables behind settings
- Roles — admin accounts and permissions
- Upgrading — back up first
MonsterOps