> For the complete documentation index, see [llms.txt](https://docs.oxygenserv.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oxygenserv.com/en/palworld/transferer-une-sauvegarde-windows-vers-linux.md).

# Transfer a Windows save to Linux

{% hint style="info" %}
This guide is for migrating a backup **Palworld** from a server **Windows** to a server **Linux**.

The map transfers directly. The **players** require a conversion.
{% endhint %}

### Goal

* Copy the backup (world + players) to the Linux server.
* Generate a new player on the Linux server side.
* Migrate the players via **palworld-host-save-fix**.

### Step-by-step guide

{% stepper %}
{% step %}
**Upload the Windows backup to the Linux server**

In the Linux server FTP, go to:

`Pal/Saved/SaveGames/0/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/`

The folder `XXXXXXXXXXXXXXXX...` is **32 characters**.

Copy your Windows backup files into this folder.

<figure><img src="/files/49e3639aa5063b1ce7635ee67b64c674d19ab202" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Start the Linux server and create a temporary character**

Start the Linux server.

Log in to the game.

Create a new character (temporary).

<figure><img src="/files/8607a6560d683e5c4e4d005becc4458468729af4" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
At this stage, the map should be correct.

We will now migrate the players.
{% endhint %}
{% endstep %}

{% step %}
**Download the updated server files (Linux side)**

Turn off the server.

Download the folder:

`Pal/Saved/SaveGames/0/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/`

Put it in a new folder on your PC.

<figure><img src="/files/04c1ab966aa0f6e7f4f934e9a3a4cfc5c03adc43" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
In `players`, you will see a new file `.sav`.

This is the temporary character from the Linux server.
{% endhint %}
{% endstep %}

{% step %}
**Migrate the players (Windows → Linux)**

Download the tool **palworld-host-save-fix** :

<https://github.com/JannikBirn/palworld-host-save-fix/releases/download/v.0.1.2/palworld-host-save-fix.exe>

{% hint style="info" %}
Windows Defender / an antivirus may block it.

Verify the source, then decide according to your security policy.
{% endhint %}

Open the application.

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

Click on **Browse**.

Select `Level.sav` in the folder you just downloaded.

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

On the next screen:

* List 1: select the “old” player (Windows).
* List 2: select the temporary player (Linux, level 0).

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

Click on **Migrate**.

Confirm the confirmation.

<figure><img src="/files/6ffdda40ab0b4db825ea90f019a8eccf908dae84" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Re-upload the converted files to the Linux server**

Send the modified files back to:

`Pal/Saved/SaveGames/0/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/`

<figure><img src="/files/71dd9eefbb9927bd686945da484af6b66be4f1b1" alt=""><figcaption></figcaption></figure>

Restart the server.

Log back into the game.

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

{% hint style="success" %}
Windows backup migrated to Linux.
{% endhint %}
{% endstep %}
{% endstepper %}

### Official resource

If you want the procedure maintained by the tool:

{% embed url="<https://github.com/xNul/palworld-host-save-fix?tab=readme-ov-file#how-to-migrate-a-windowslinux-dedicated-server-save-to-a-linuxwindows-dedicated-server>" %}

### Common issues

#### The server starts on a new map

* Check the folder `.../SaveGames/0/<32-characters>/`.
* Copy the contents, not the parent folder.
* Stop the server during the upload.

#### Players no longer have their progress

* The players' migration was not done.
* The wrong pair “old player” → “temporary player” was chosen.

#### The tool is blocked by Windows / antivirus

* Download only from the GitHub link.
* Scan the file if necessary.

### FAQ

#### Do I have to migrate all players?

Yes. Each player has a file `.sav` in `players`.

#### Why avoid `WorldOption.sav` ?

This file can overwrite the server settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/palworld/transferer-une-sauvegarde-windows-vers-linux.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.
