# Create a backup and restore it

{% hint style="info" %}
Backups are useful before an update, adding a mod, or a major config change.
{% endhint %}

### Objective

Create a **file backup**, then the **restore** if needed.

### Step-by-step guide

{% stepper %}
{% step %}
**Create a backup**

Click on **Create a backup**.

<figure><img src="/files/55f1d8c17a0f3597b78f9d6ae5c703d324a11b57" alt=""><figcaption></figcaption></figure>

Fill in:

* **Name** (e.g. `Pre-update-2026-01-06`)
* **Files and folders to ignore** (optional)
* **Lock** (optional)

Click on **Create** to start the backup.

{% hint style="info" %}
The **lock** prevents accidental deletion.\
Enable it for an important “restore point” backup.
{% endhint %}

{% hint style="warning" %}
You have a **limited number of backups**.\
If needed, delete an old backup before creating a new one.
{% endhint %}
{% endstep %}

{% step %}
**Restore a backup**

In **Backups**, find the backup to use then click **Restore**.

<figure><img src="/files/81240b83aac90893065b5a56709e4824e22823af" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
A restore **overwrites** replaces the current files with those from the backup.\
Make a “before restore” backup if you are unsure.
{% endhint %}
{% endstep %}
{% endstepper %}

### Common issues

* **Unable to create a backup** : check that you have not reached the limit. Delete an unneeded backup.
* **Backup stuck / very long** : try again later if the server is under heavy load.
* **After restore, the server won't start** : restore an older backup, then contact support with the time and names of the backups.

### FAQ

#### Do I need to stop the server before a backup or restore?

For the **restore**, it's generally preferable.\
It limits files being written (depending on the game and plugins).

#### What is “Folders to ignore” for?

To exclude large or regenerable folders.\
Typical examples: `cache`, `logs`, temporary files.

#### What should I send to support if a restore fails?

The **backup name**, and a screenshot of the error message if present.\
Then: [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-et-la-restaurer-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.
