# Create a database backup

{% hint style="info" %}
A database backup allows you to roll back after an update or a mistake.\
You can also **download** the backup to keep it locally.
{% endhint %}

### Objective

Create a **backup** of the database, then **download** or the **restore** if necessary.

### Step-by-step guide

{% stepper %}
{% step %}
**Start creating a backup**

On the relevant database, open the menu **⋯** then click **Create a backup**.

<figure><img src="/files/11e51185c9496117722edd42aa162f37ed44752d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Name and confirm**

Give a **name** to the backup (e.g. `before-update-2026-01-06`) then confirm.
{% endstep %}

{% step %}
**Download the backup**

Wait for the backup to be in **finished** (or available).

On the line for the backup, open the menu **⋯** then click **Download**.

<figure><img src="/files/5d05888edeee275ca6e4b3e52c7d306205f6ef81" alt=""><figcaption></figcaption></figure>

You will get an export of the database (SQL file).
{% endstep %}

{% step %}
**Restore the backup**

On the line of the backup to use, click **Restore**.

<figure><img src="/files/be5112b8954c4ccb265fac194e912aa5fa2e4866" alt=""><figcaption></figcaption></figure>

Confirm the operation, then wait for the restoration to complete.

{% hint style="warning" %}
The restoration **overwrites** the current state of the database.\
Make a “before restore” backup if you are unsure.
{% endhint %}
{% endstep %}
{% endstepper %}

### Common issues

* **Very long backup** : wait for the operation to finish, especially on a large database.
* **Error during restoration** : restore an older backup, then contact support with the name + time of the test.

### FAQ

#### What is the difference between “server backup” and “database backup”?

Server backup concerns the **files**.\
DB backup only concerns the **MySQL database** (application data).

#### When to make a database backup?

Before an update, adding a plugin/mod, or a migration.

#### What to provide to support if a backup/restoration fails?

The **backup name**, and a screenshot of the error if displayed: [Contact Oxygenserv support (ticket dashboard and Discord)](/en/dashboard/contacter-le-support-oxygenserv-ticket-dashboard-et-discord.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.oxygenserv.com/en/dashboard/creer-une-sauvegarde-de-base-de-donnees-sur-son-serveur.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.