> ## 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).

# System Update

> Keep your OwnPay instance up to date with one-click updates, automatic backups, and a rollback procedure if anything goes wrong.

OwnPay provides a one-click update system that keeps your instance current with the latest features, security patches, and bug fixes.

## Check for updates

Navigate to **System > System Update**. The page shows your current version and whether a newer release is available. If an update is found, the new version number and a summary of changes are displayed.

<Info>
  You can also check the [OwnPay GitHub releases](https://github.com/own-pay/OwnPay) page for the full changelog.
</Info>

## Update process

<Steps>
  <Step>
    Click **Check for Updates** to query the update server.
  </Step>

  <Step>
    If an update is available, review the changelog and click **Update Now**.
  </Step>

  <Step>
    OwnPay automatically creates a full backup of your current installation (files and database) before applying the update.
  </Step>

  <Step>
    The update downloads and extracts the new version, runs database migrations, and clears caches.
  </Step>

  <Step>
    You are redirected to the login page once the update completes.
  </Step>
</Steps>

## Post-update steps

After every update, perform these checks:

1. **Log in** and verify the dashboard loads correctly
2. **Check the Environment Info** panel in [Settings](/docs/system/settings) to confirm the new version
3. **Test a checkout** on at least one brand to ensure payment flows work
4. **Review plugin compatibility** - some plugins may need updates after a major OwnPay release

<Tip>
  OwnPay automatically clears the Redis cache after an update. If you see stale data, manually refresh the page.
</Tip>

## Rollback procedure

If something goes wrong after an update, you can roll back to the previous version:

<Steps>
  <Step>
    Navigate to **System > System Update**.
  </Step>

  <Step>
    If a rollback is available, click **Rollback to v**0.2.0.
  </Step>

  <Step>
    OwnPay restores the backup created before the update.
  </Step>

  <Step>
    Verify the rollback by checking the version in Settings > Environment Info.
  </Step>
</Steps>

<Warning>
  Rollback restores files and database to the pre-update state. Any transactions processed between the update and the rollback are preserved in the database - they are not reverted.
</Warning>

## Update via CLI

For advanced users or automated deployment pipelines, you can update OwnPay from the command line:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
php /path/to/ownpay/artisan update:run
```

This command performs the same backup-and-update flow as the web UI. Use `--no-backup` to skip the automatic backup if you have your own backup strategy.

<Info>
  For migration guidance between major versions, see the [Migration Guide](/docs/resources/migration-guide).
</Info>

## Related Pages

* [Settings](/docs/system/settings) - Verify version and environment after updating
* [Backup & Export](/docs/resources/backup-export) - Manual backup procedures
* [Migration Guide](/docs/resources/migration-guide) - Major version upgrade instructions


## Related topics

- [OwnPay Ecosystem - SDKs, Plugins, Companion App, and Marketplace](/docs/resources/ecosystem.md)
- [Features and Capabilities](/docs/resources/features.md)
- [Audit Log](/docs/reports/audit-log.md)
- [Settings](/docs/system/settings.md)
- [Roles and permissions](/docs/people/roles.md)