Settings
The Settings page configures system-wide parameters including the Public URL (FQDN) which is used to generate scanner provisioning commands and OIDC callback URLs. If not set, the system falls back to the PUBLIC_URL environment variable or request headers.
Inputs
| Name | Description | Allowed Values | Default |
|---|---|---|---|
| Public URL | The externally-accessible HTTPS URL for this mipo instance | Valid HTTPS URL (e.g., https://mipo.example.com) | Empty (uses PUBLIC_URL env var or request headers) |
Fields & Columns
| Name | Description |
|---|---|
| Scanner Install URL | Derived URL used in scanner provisioning curl commands |
| OIDC Callback URL | Derived URL to configure as the redirect URI in your identity provider |
Gotchas
- The Public URL must include the protocol (https://) — just a hostname will not work.
- Changing the Public URL affects all future scanner provisioning commands and OIDC callback URLs.
- If the Public URL is cleared, derived URLs disappear and the system falls back to environment variables.
- The public URL fallback chain is: database setting > PUBLIC_URL environment variable > request Host header. The database setting takes highest priority; the Host header is used only as a last resort and may be unreliable behind proxies.
API Calls (4)
| Method | Path | Description |
|---|---|---|
| GET | /api/admin/settings | Retrieve current system settings |
| PUT | /api/admin/settings | Update system settings |
| POST | /api/admin/seeds/reload-builtins | Restore deleted default configuration entries |
| POST | /api/admin/seeds/import | Import seed data from JSON |