> ## 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/plugin-types/ pages for correct interfaces and manifests.

# Login - Sign In to the OwnPay Admin Dashboard

> Sign in to the OwnPay admin dashboard as a super-administrator or staff member using your email, password, and an optional 2FA verification code.

The Login page is the primary security gate of the OwnPay platform. To prevent unauthorized access to sensitive financial ledger data, only pre-registered staff members and the super-administrator can sign in. The page supports brute-force lockout protections and secure session management.

## Getting here

Open your web browser and navigate to your master OwnPay domain followed by the login slug: `https://your-domain.com/login`

<Note>
  The default slug is `login`, but this can be customized in the Landing Page settings for additional security.
</Note>

## Fields and options reference

| Field / Option        | Type              | Required | Default   | Description                                                        |
| --------------------- | ----------------- | -------- | --------- | ------------------------------------------------------------------ |
| **Email or Username** | Text              | Yes      | -         | The pre-registered email address or username                       |
| **Password**          | Password          | Yes      | -         | The secure password associated with your account. Case-sensitive   |
| **Remember me**       | Toggle / Checkbox | No       | Unchecked | Keeps your session active for a longer duration                    |
| **Sign In**           | Button            | Yes      | -         | Submits your credentials to verify and logs you into the dashboard |
| **Forgot password?**  | Link              | No       | -         | Redirects you to the password recovery request page                |

## Step-by-step

1. Enter your registered email address or username in the **Email or Username** field
2. Input your secure password in the **Password** field
3. (Optional) Check the **Remember me** box if you are logging in from a private, trusted device
4. Click the **Sign In** button
5. If Two-Factor Authentication (2FA) is enabled, you will be redirected to the 2FA entry screen. Otherwise, you will land directly on the **Dashboard**

## Configuration guide

* **Admin Login URL Slug:** You can change the route from `/login` to a customized slug under the Landing Page Settings
* **Brute-Force Lockout:** After five (5) failed login attempts within a 5-minute window, the account is temporarily locked

## Best practices

* Change the default `/login` slug to a random, hard-to-guess word to mask the admin panel from automated bot scanners
* Only check the **Remember me** option on personal, fully encrypted devices
* Do not share login credentials among staff members. Always create dedicated staff accounts
* Do not attempt to log in over a public, unencrypted HTTP connection

<Warning>
  Always ensure that the browser address bar displays the correct domain name and a secure lock icon (SSL/TLS active) before entering your credentials.
</Warning>

## Common mistakes and troubleshooting

| Symptom                                | Likely Cause                          | Fix                                                                      |
| -------------------------------------- | ------------------------------------- | ------------------------------------------------------------------------ |
| `Invalid credentials` error message    | Typo in email/username or password    | Re-verify your credentials. Note that passwords are case-sensitive       |
| `Account temporarily locked` error     | Too many incorrect login attempts     | Wait 5 minutes for the lockout window to expire                          |
| `404 Not Found` when visiting `/login` | The admin login slug has been changed | Access the admin panel using the custom slug configured in your settings |

## Related pages

* [Forgot Password](/user-guide/auth/forgot-password) - Request password reset instructions
* [Two-Factor Authentication](/user-guide/auth/two-factor) - The next step in the login flow if 2FA is active


## Related topics

- [Forgot Password - Reset Your OwnPay Admin Password](/docs/user-guide/auth/forgot-password.md)
- [Explore the OwnPay Demo - Try the Live Payment Dashboard](/docs/demo.md)
- [Node.js SDK - TypeScript-First Payment Integration](/docs/developer/integration/nodejs.md)
- [OwnPay API Overview - REST API for Multi-Brand Payments](/docs/api/overview.md)
- [Developer Quickstart - Build Your First Payment Integration](/docs/developer/quickstart.md)