---
title: 'Installation & Upgrade'
url: 'https://manuals.remository.com/userpoints/installation'
markdown: 'https://manuals.remository.com/userpoints/installation.md'
date: '2026-10-06'
description: 'Requirements UserPoints requires: Requirement Minimum version Joomla! 5.x or 6.x PHP 8.2 MySQL 5.7 MariaDB 10.4 Installing UserPoints Download the UserPoints package from Remository. The package is a single ZIP file that installs the component, all bundled modules, and the core plug…'
taxonomy:
  category:
    - docs
---

[](#) [ edit this page](https://github.com/getgrav/grav-skeleton-rtfm-site/blob/develop/pages/02.installation/docs.md) 

# Installation & Upgrade

## Requirements

UserPoints requires:

| Requirement | Minimum version |
|---|---|
| Joomla! | 5.x or 6.x |
| PHP | 8.2 |
| MySQL | 5.7 |
| MariaDB | 10.4 |

## Installing UserPoints

Download the UserPoints package from [Remository](https://remository.com). The package is a single ZIP file that installs the component, all bundled modules, and the core plugins in one operation.

1. In the Joomla administrator, go to **System → Install → Extensions**.
2. Upload the ZIP file using the **Upload Package File** tab.
3. Joomla will install the component and display a confirmation message.

The installation script automatically:

- Creates all required database tables.
- Installs and publishes all bundled plugins.
- Installs all bundled modules.

### Post-installation steps

After installation, visit **Components → UserPoints** to open the control panel. Before going live:

1. **Install rule plugins** — go to **UserPoints → Plugins** and upload any rule plugins you have obtained. Each plugin normally adds one or more configurable rules to the system. Publish if you want them activated.
2. **Auto-detect new rules** — after uploading software that integrates with UserPoints, including new plugins, click the **Auto-detect new rules** control panel button. This scans all installed UserPoints plugins and creates matching rule definitions automatically.
3. **Publish rules** — visit **UserPoints → Rules** and publish the rules you want active. Newly detected rules start unpublished. Review the configuration of rules you are using.
4. **Configure the component** — review the settings described in the [Configuration](https://manuals.remository.com/userpoints/configuration) page.

## Upgrading

You can keep UserPoints up to date using the Joomla update manager - see below. Otherwise, upgrading follows the same process as a fresh installation. Install the new package over the existing one; Joomla and the UserPoints installation script apply any required database schema changes automatically.

Before upgrading a production site, take a full file and database backup.

### Joomla Update and Key

To receive update notifications in the Joomla update manager, make sure you have the Remository Update Authentication plugin, and publish and configure it with your **Update Key**. Your key is available on your Remository account profile.

 [](https://manuals.remository.com/userpoints/configuration)

---

## Navigation

- Previous: [UserPoints User Manual](https://manuals.remository.com/userpoints/index.md)
- Next: [Configuration](https://manuals.remository.com/userpoints/configuration.md)