> ## Documentation Index
> Fetch the complete documentation index at: https://ownpay.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> OwnPay is licensed under AGPL-3.0 and is completely free - no licensing fees.
> Production docs URL: https://ownpay.org/docs - append .md to any page URL for clean markdown.
> OwnPay requires PHP 8.3+, MySQL/MariaDB, and Redis.
> MCP server available at https://ownpay.org/docs/mcp for programmatic documentation queries.
> Use root-relative links (e.g. /quickstart) for internal navigation - do NOT include /docs prefix.
> Plugin development: consult /developer/plugins/ pages for correct interfaces and manifests.
> Canonical locations: API auth = /api/authentication, webhook verification = /api/webhooks, rate limits = /resources/rate-limiting, transaction statuses = /fundamentals/payment-flow.
> The documentation uses the Diataxis framework: Tutorials (learning), How-to (tasks), Reference (lookup), Explanation (understanding).

# Settings

> Configure application name, URL, timezone, maintenance mode, mail settings, and advanced options from the general settings page.

The Settings page is the central configuration hub for your OwnPay instance. It is organized into tabbed sections covering application, mail, security, and advanced settings.

## Getting here

Click **Settings** in the left sidebar under the **System** section.

## Application settings

| Setting              | Description                                                                                 |
| -------------------- | ------------------------------------------------------------------------------------------- |
| **Application Name** | Displayed in the browser tab title and email subjects                                       |
| **Application URL**  | The canonical URL of your OwnPay instance. Used for generating links in emails and webhooks |
| **Timezone**         | Sets the default timezone for all timestamps in the admin panel and reports                 |
| **Maintenance Mode** | When enabled, shows a maintenance page to visitors. Staff can still log in                  |

<Note>
  Changing the Application URL after initial setup requires updating webhook endpoints and any external integrations that store your instance URL.
</Note>

## Mail settings

The Mail tab exposes the SMTP configuration used by the [mail-gateway addon](/docs/notifications/email). Fill in host, port, credentials, encryption, and the default from address. See the [email notifications](/docs/notifications/email) page for detailed SMTP setup instructions.

## Security settings

The Security tab provides links to related configuration:

* **Session lifetime** - How long an idle session stays active
* **Password policy** - Minimum length, complexity requirements
* **Login rate limit** - Maximum failed attempts before lockout
* **Enforce 2FA** - Require two-factor authentication for specific roles

<Info>
  For a comprehensive overview of all security features, see [Security & Compliance](/docs/resources/security-compliance).
</Info>

## Advanced settings

The Advanced tab contains options most users do not need to change:

* **Audit log retention** - Automatic pruning period in days (`0` = keep forever)
* **Cache TTL** - Redis cache duration for dashboard and report data
* **Debug mode** - Enables verbose error logging. Never enable in production

## Environment info

At the bottom of the Settings page, an **Environment Info** panel displays:

* OwnPay version (`0.2.0`)
* PHP version (must be 8.3+)
* MySQL version
* Redis connection status
* Available disk space

Use this panel to quickly verify your server meets requirements after an update.

## Related Pages

* [Email Notifications](/docs/notifications/email) - Full SMTP and template configuration
* [Security & Compliance](/docs/resources/security-compliance) - Security best practices and feature overview
* [System Update](/docs/system/system-update) - Keep your instance up to date


## Related topics

- [Brand identity settings](/docs/appearance/branding.md)
- [OwnPay Architecture: PHP Core, Middleware, and Plugins](/docs/resources/architecture.md)
- [Configure payment gateways](/docs/gateways/configuration.md)
- [Email Notifications](/docs/notifications/email.md)
- [Features and Capabilities](/docs/resources/features.md)