---
title: "How to Install Azuriom on Your Plesk Web Hosting"
description: "Install the Azuriom game CMS on your Winheberg Plesk web hosting, PHP 8.4, MariaDB database, official installer, game choice, administrator account and CRON task."
category: cloud
subcategory: hebergement-web
icon: tabler:file-text
date: 2026-11-01
author: Winheberg
slug: "install-azuriom-plesk"
order: 124
image: /statics/images/docs/en/hebergement-web/install-azuriom-plesk.webp
tags: [Azuriom, Plesk, CMS, Minecraft, Web Hosting]
keywords: [install azuriom, azuriom plesk, minecraft cms, minecraft server website, game cms, azuriom web hosting]
link_fr: "/docs/hebergement-web/installer-azuriom-plesk"
---

## Context

Azuriom is a free and open source game CMS, designed to build your server website and to grow with themes and plugins, such as a shop. It supports many games, including Minecraft, Minecraft Bedrock, Hytale, Garry's Mod, Rust or FiveM. If you do not have a server yet, have a look at our [Minecraft](https://winheberg.com/en/gaming/minecraft) and [Hytale](https://winheberg.com/en/gaming/hytale) offers.

Written in PHP, it installs on your [Winheberg web hosting](https://winheberg.com/en/cloud/web-hosting) without any SSH access. An official installer checks the requirements, downloads Azuriom, configures the database and creates your administrator account.

This guide covers the whole installation from Plesk, from the PHP setting to the scheduled task that runs the shop automatic features.

> [!NOTE]
> The Winheberg Plesk panel is displayed in French, and so is the Azuriom installer when your browser is in French. Menu, field and button names are quoted below exactly as they appear on screen, followed by their English meaning.

## Prerequisites

- A Winheberg web hosting plan with access to the Plesk panel
- A domain already connected to the hosting, see our guide [How to Connect an External Domain to Your Plesk Hosting](https://winheberg.com/en/docs/hebergement-web/connect-external-domain-plesk)
- Your choice of game and login mode, which cannot be changed after the installation

::MdTable{caption="Azuriom technical requirements" variant="info" striped footer="Source, the official Azuriom documentation. Everything is already in place on our web hosting plans, the installer confirms it."}
| Item | Requirement |
|---|---|
| PHP | 8.2 minimum, 8.4 or 8.5 recommended |
| PHP extensions | BCMath, Ctype, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML, XMLWriter, cURL and ZIP |
| Database | MySQL or MariaDB recommended |
| Web server | URL rewriting enabled and symlink support |
::

> [!CAUTION]
> Azuriom installs at the website root, in `httpdocs`. If a website is already live on that domain, back it up before starting or install Azuriom on a subdomain.

## 1. Switch the website to PHP 8.4

From **Sites Web & Domaines** (*Websites & Domains*), open your domain. In the **Tableau de bord** (*Dashboard*), **Outils Dévelop.** (*Dev Tools*) section, click **PHP**. On the **Paramètres PHP** (*PHP Settings*) page, pick an **8.4** version in the **Prise en charge de PHP** (*PHP support*) list, then confirm with **OK**.

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793569971500-1e15de421a708988c2d5eba8.webp" alt="PHP 8.4 version selected in the Plesk PHP Settings" width="780" />

Plesk picks the **Application FPM servi(e) par Apache** (*FPM application served by Apache*) mode on its own, keep it.

## 2. Create the database

Open **Bases de données** (*Databases*) in the side menu, then click **Ajouter une base de données** (*Add Database*).

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793570934028-fb77e90466fd5bc9f30156ea.webp" alt="Bases de données (Databases) menu of Plesk and the Ajouter une base de données (Add Database) button outlined in red" width="788" />

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793569971905-24a42ff4f68cab6be7c4f7e4.webp" alt="Plesk Add Database form for Azuriom" width="624" />

Complete the **Nom de la base de données** (*Database name*) after the prefix Plesk adds for your account, pick your domain in **Site associé** (*Related site*), then enter a **Nom de l'utilisateur de la base de données** (*Database user name*). Click **Générer** (*Generate*) to get a strong password, copy it, then confirm with **Créer la base de données** (*Create database*).

Keep this information at hand, the installer asks for it in step 6.

::MdTable{caption="Information to enter in the installer" variant="info" striped}
| Installer field | Value |
|---|---|
| Type | MySQL/MariaDB |
| Adresse (*Host*) | `localhost` |
| Port | `3306` |
| Base de données (*Database*) | The full name, prefix included |
| Utilisateur (*User*) | The user name created above |
| Mot de passe (*Password*) | The password generated by Plesk |
::

## 3. Upload the Azuriom installer

Open **Fichiers** (*Files*) in the side menu and go into `httpdocs`. Click **+**, then **Importer le fichier via l'URL** (*Import file from URL*).

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793569972292-e2617965643cdc320b837892.webp" alt="Import file from URL menu of the Plesk file manager" width="786" />

Paste the address of the official installer below, then click **Importer** (*Import*). Plesk fetches the `AzuriomInstaller.zip` file directly, without going through your computer.

```text
https://github.com/Azuriom/AzuriomInstaller/releases/latest/download/AzuriomInstaller.zip
```

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793569972672-62022f5a7ce5a8c936eed063.webp" alt="Azuriom installer URL entered in the Plesk import window" width="524" />

> [!TIP]
> You can also download the installer from the [Azuriom download page](https://azuriom.com/en/download), then send it with **Téléverser le fichier** (*Upload file*).

## 4. Extract the archive

Tick `AzuriomInstaller.zip`, open the **Archive** menu and pick **Extraire les fichiers** (*Extract files*). Keep `/httpdocs` as the destination folder and confirm with **OK**.

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793569973041-037c73d20c1ab3a4549caefc.webp" alt="Archive menu and Extract files for AzuriomInstaller.zip" width="786" />

Extraction adds an `index.php` file, an `.htaccess` file and a `public` folder. You can then delete the `AzuriomInstaller.zip` archive.

> [!NOTE]
> The Azuriom documentation asks to set file permissions to 775. This is not needed on our web hosting plans, PHP runs as your subscription user and the installer accepts the default permissions.

## 5. Run the installer

Open your domain in a browser. The installer checks your server and displays **Votre serveur a les pré-requis pour installer Azuriom** (*Your server meets the requirements to install Azuriom*). Click **Continuer** (*Continue*).

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793569973474-278d9184cdf01244e5da149c.webp" alt="Azuriom installer stating the server meets the requirements" width="726" />

At the **Téléchargement** (*Download*) step, click **Télécharger** (*Download*). The installer fetches the latest Azuriom version, which can take a few minutes.

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793569973845-cf214d2372eea9a8bcb03b37.webp" alt="Download step of the Azuriom installer" width="720" />

When the installer says Azuriom is ready to be configured, click **Continuer**.

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793569974278-286c9583768252ccaef47016.webp" alt="Azuriom installer ready to be configured" width="720" />

## 6. Enter the database details

Pick **MySQL/MariaDB** in **Type**, then enter the information noted in step 2. Click **Continuer**.

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793569974634-d999b49d257219a0a57d390f.webp" alt="Database step of the Azuriom installer" width="720" />

> [!NOTE]
> The installer also offers SQLite, PostgreSQL and SQLServer. The Azuriom documentation recommends MySQL or MariaDB, which is what your hosting provides.

## 7. Pick the game

Click your server game in the list, for instance **Minecraft**, **Minecraft: Bedrock Edition**, **Hytale (Early Access)**, **FiveM** or **Rust**.

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793569975452-323a5b740a8394f2f3b16df1.webp" alt="Game choice in the Azuriom installer" width="720" />

> [!WARNING]
> As the installer points out, the game type and the login mode cannot be changed once the installation is done, short of reinstalling Azuriom entirely.

## 8. Create the administrator account

The form depends on the chosen game. For Minecraft, first pick the website **Langue** (*Language*), then the login mode.

::MdTable{caption="Login with a Microsoft account for Minecraft" variant="info" striped}
| Choice | What the installer asks for the admin account |
|---|---|
| Oui (*Yes*) | The administrator **Minecraft UUID**, login then goes through a Microsoft account that owns Minecraft |
| Non (*No*) | A **Pseudo** (*Username*), an **Adresse E-Mail** (*Email address*), a **Mot de passe** (*Password*) and its **Confirmation du mot de passe** (*Password confirmation*) |
::

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793569975860-3ef3f06a7ce6fd339debb20a.webp" alt="Microsoft login choice and Azuriom admin account creation" width="720" />

Click **Installer** (*Install*). Once the installation is done, your website shows its home page.

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793570714247-d34c58be7e506cf7b76eccef.webp" alt="Azuriom home page after installation with the Login link" width="790" />

Click **Connexion** (*Login*) and sign in with the administrator account, then click your name at the top right to reach the administration dashboard.

## 9. Schedule the CRON task

Some Azuriom features, such as automatic renewal of shop subscriptions, need a task that runs every minute.

From your domain **Tableau de bord**, **Outils Dévelop.** section, open **Tâches planifiées** (*Scheduled Tasks*), then click **Ajouter une tâche** (*Add Task*). Fill in the form as shown below, then confirm with **OK**.

<img src="/statics/images/docs/en/hebergement-web/install-azuriom-plesk-1793569975011-f2e0acca7249229cdf0e83b3.webp" alt="Plesk scheduled task running artisan schedule:run every minute" width="770" />

::MdTable{caption="Scheduled task settings" variant="info" striped}
| Field on screen | Value |
|---|---|
| Type de tâche (*Task type*) | **Exécuter un script PHP** (*Run a PHP script*) |
| Chemin d'accès du script (*Script path*) | `httpdocs/artisan` |
| avec arguments (*with arguments*) | `schedule:run` |
| Utiliser la version de PHP (*Use PHP version*) | The same version as the website, for instance 8.4 |
| Exécuter (*Run*) | **Style Cron** (*Cron style*), with `* * * * *` |
| Description | Azuriom, to find it easily |
::

## 10. Enable the SSL certificate

To serve your website over HTTPS, install the free Let's Encrypt certificate from **Certificats SSL/TLS** (*SSL/TLS Certificates*) by following our guide [How to Generate a Let's Encrypt SSL Certificate for Your Website](https://winheberg.com/en/docs/hebergement-web/lets-encrypt-ssl-certificate-plesk).

## Troubleshooting

### ❌ The home page works but other pages return a 404 error

URL rewriting does not apply, most often because an `.htaccess` file is missing.

- Check in the file manager that `.htaccess` is present in `httpdocs` and in `httpdocs/public`
- If you uploaded the files over FTP, enable hidden files in your client so they are transferred
- Extract the archive again with the **Remplacer les fichiers existants** (*Replace existing files*) box ticked

### ❌ Images are not displayed

The link between the storage folder and the public folder is missing or broken.

- Delete the `public/storage` folder if it exists, but never the `storage` folder at the root
- Then open the `/admin/settings/storage/link` address of your website, logged in with your administrator account

### ❌ Uploading an image fails

By default PHP limits the size of an uploaded file to 2 MB, the `upload_max_filesize` value shown in **Paramètres PHP**.

- Resize the image before uploading it, as Azuriom recommends to keep the website fast
- Compress it into a light format such as WebP

### ❌ The database credentials have changed

Azuriom reads its credentials from the `.env` file at the website root.

- Open `httpdocs/.env` in the Plesk code editor and fix the database values
- Then delete the `bootstrap/cache/config.php` file if it exists

## Best practices

- Choose the game and login mode before starting the installation, they are final
- Stay on PHP 8.4 or 8.5, the versions recommended by Azuriom
- Store the database credentials in a password manager
- Delete the `AzuriomInstaller.zip` archive once the installation is done
- Resize your images before uploading them to the website
- To let a team member handle files or the database without sharing your login, follow our guide [How to Create a User in Plesk](https://winheberg.com/en/docs/hebergement-web/create-user-account-plesk)

## Need help?

If the installation gets stuck on your hosting, open a ticket with our support from your [client area](https://billing.winheberg.com), **Technical** department, filling in the **Related Product** field with the web hosting concerned. For questions about the CMS itself, its themes and plugins, see the [official Azuriom documentation](https://azuriom.com/en/docs) or join its [Discord](https://azuriom.com/discord).

Your server website is ready to welcome your players 🎮

