> For the complete documentation index, see [llms.txt](https://islamu.gitbook.io/islamu-event/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://islamu.gitbook.io/islamu-event/documentation/readme/configuration-and-operations.md).

# Configuration & Operations

Configuration, secrets, backup, upgrade, health, and recovery runbooks.

This section covers the operational contract after selecting a deployment topology. Keep configuration parameters, secret values, application relational data, and privacy-erasure authority distinct: each possesses a different backup mechanism and trust boundary.

***

## In this Section

* [**Environment Variables**](/islamu-event/documentation/readme/configuration-and-operations/environment-variables.md) — Master reference for baseline settings (`.env.example`) and advanced built-in defaults.
* [**Configuration Manifests**](/islamu-event/documentation/readme/configuration-and-operations/configuration-manifests.md) — Version and export governed tenant settings without secrets, PII, or application data.
* [**Secrets Management**](/islamu-event/documentation/readme/configuration-and-operations/secrets.md) — Select fail-closed secret authorities (Environment or Infisical) and rotate credentials safely.
* [**Infisical Setup**](/islamu-event/documentation/readme/configuration-and-operations/infisical.md) — Create the Infisical project, folder tree, machine identity, and bootstrap inputs the platform reads.
* [**Backup, Restore & Upgrade**](/islamu-event/documentation/readme/configuration-and-operations/backup-restore-upgrade.md) — Protect every durable authority and rehearse recovery procedures.
* [**Troubleshooting & Operational Health**](/islamu-event/documentation/readme/configuration-and-operations/troubleshooting-and-health.md) — Step-by-step diagnostic recipes for startup, identity, policy, and provider issues.

***

## Operational Lifecycle

1. Start by reviewing [**Environment Variables**](/islamu-event/documentation/readme/configuration-and-operations/environment-variables.md) and configuring your `.env` file from the baseline template.
2. Store passwords and API keys securely according to [**Secrets Management**](/islamu-event/documentation/readme/configuration-and-operations/secrets.md).
3. Establish automated backup scripts as detailed in [**Backup, Restore & Upgrade**](/islamu-event/documentation/readme/configuration-and-operations/backup-restore-upgrade.md).
4. Consult [**Troubleshooting & Health**](/islamu-event/documentation/readme/configuration-and-operations/troubleshooting-and-health.md) if containers fail startup health probes.

***

## Related Guides & Next Steps

* [**Docker Compose Runbook**](/islamu-event/documentation/readme/self-hosting/docker-compose.md) — Production split container deployment.
* [**Docker Standalone Runbook**](/islamu-event/documentation/readme/self-hosting/docker-standalone.md) — Single-container deployment with SQLite.
* [**Authentication Setup**](/islamu-event/documentation/readme/security-and-identity/authentication.md) — Configure Keycloak OIDC integration.
* [**First-Run Administration Guide**](/islamu-event/documentation/readme/administration-and-branding/admin-guide.md) — Complete instance onboarding in the browser.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://islamu.gitbook.io/islamu-event/documentation/readme/configuration-and-operations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.