> For the complete documentation index, see [llms.txt](https://docs.openiam.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openiam.com/administration-guide/platform.md).

# Configure platform services

Route to the platform-wide service you need to configure — properties, mail, OTP delivery, localization, consent, promotion or a supporting service.

## What this is, and when you need it

Everything in this section is configured once for the installation rather than per user, per application or per managed system. The settings here decide what the console *says* (localization), how it *reaches* people (mail, SMS, OTP), what it *demands* before letting them in (consent), and how you move a working configuration from one environment to the next.

Two pages come first regardless of your task:

* [**System configuration**](/administration-guide/platform/system-configuration.md) is the single screen behind `/webconsole/propertyValues` and one table, `PROPERTY_FILE_VALUES`. Almost every property named in this section is edited there.
* [**Where settings live**](/administration-guide/start/where-settings-live.md) explains the four layers a value can come from and which one the running service actually reads. A container `OPENIAM_PROP_*` override is invisible from the Webconsole, so if a value on screen does not match the behaviour, start there.

## Choose your outcome

| I want to…                                                                       | Go to                                                                                                                                                      |
| -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Change a property, or find out what it ships as                                  | [System configuration](/administration-guide/platform/system-configuration.md) → [System properties](/administration-guide/reference/system-properties.md) |
| Make OpenIAM send email, or change what a notification says                      | [Mail and notifications](/administration-guide/platform/mail-and-notifications.md)                                                                         |
| Deliver a one-time code by SMS, voice call or email                              | [SMS and one-time passwords](/administration-guide/platform/sms-and-otp.md)                                                                                |
| Make a menu, role or resource name appear in another language                    | [Languages and localization](/administration-guide/platform/localization.md)                                                                               |
| Require an acceptable-use or privacy acknowledgement before access               | [Consent and IT policy](/administration-guide/consent/consent-and-it-policy.md)                                                                            |
| Move configuration between environments                                          | [Promote configuration between environments](/administration-guide/platform/import-export-and-promotion.md)                                                |
| Look up an object type, a config key or a command flag for the promotion utility | [Import and export reference](/administration-guide/platform/import-export-and-promotion/import-export-reference.md)                                       |
| Find out what a recoverable backup has to cover                                  | [What a backup and restore must cover](/administration-guide/platform/backup-and-restore-scope.md)                                                         |
| Generate a unique employee ID, badge number or login from a script               | [Define a sequence generator](/administration-guide/platform/sequence-generators.md)                                                                       |
| Turn a client IP into a country or city, so an adaptive rule can branch on it    | [Set up geo-IP lookup](/administration-guide/platform/geo-ip-lookup.md)                                                                                    |
| Add a counter tile to the analytics dashboard, or fix one whose number is wrong  | [Configure an analytics dashboard tile](/administration-guide/platform/analytics-dashboard.md)                                                             |

## What is *not* here

| Task                                                                                | Owner                                                                                                                                                                                           |
| ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| The reverse proxy, content providers and URI patterns                               | [Administer the Access Gateway](/administration-guide/gateway.md) — note the `Gateway` property category is the SMTP mail gateway, not the Access Gateway                                       |
| Authentication providers, policies, MFA levels and rules                            | [Secure sign-in and credentials](/administration-guide/security.md)                                                                                                                             |
| Connectors, managed systems, provisioning and reconciliation                        | [Connect applications and automate lifecycle](/administration-guide/lifecycle.md)                                                                                                               |
| Audit search, audit export to a SIEM, log levels, index rebuilds                    | [Monitor and maintain OpenIAM](/administration-guide/operations.md)                                                                                                                             |
| Whether a service is alive, and why one can report `UP` while the product is broken | [Diagnose a failed operation](/administration-guide/operations/diagnose-a-failed-operation.md) — reading the health files themselves is the [Installation Guide](/installation/installation.md) |
| Batch task schedules and the Groovy script catalogue                                | [Customize and automate](/administration-guide/automation.md)                                                                                                                                   |

## Two shipped defaults worth knowing before you start

{% hint style="warning" %}
**The OTP email body has a blank line until you set one property.** `OTP_CODE` renders `companyName` from `org.openiam.ui.page.title.organization.name`, which ships empty. See [SMS and one-time passwords](/administration-guide/platform/sms-and-otp.md).

**Adding a language does not translate anything.** Object names are `LANGUAGE_MAPPING` rows and a missing row leaves the raw `RES.NAME` identifier on screen — `OTP_PROVIDERS`, not "OTP Providers". See [Languages and localization](/administration-guide/platform/localization.md).
{% endhint %}

Before any change here, read [Change configuration safely](/administration-guide/start/change-safely.md) once. It is the safety standard these pages assume rather than repeat.

*Applies to OpenIAM 2026.8.1. Last reviewed 7 August 2026.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.openiam.com/administration-guide/platform.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.