Emby Windows to Linux migration, preserving library, users, watched status, posters and metadata

[emecuatro 0]

Hi,

I recently migrated my Emby Server from **Windows to Linux**, moving my media paths from SMB/Windows format:

\\nas\Pelis
\\nas\Series
\\nas\Musica

to Linux/NFS paths:

/mnt/NAS/Pelis
/mnt/NAS/Series
/mnt/NAS/Musica

The main issue was that restoring the backup was not enough, because some paths were still stored inside the SQLite databases, including:

• media paths
• image/poster paths
• %MetadataPath% paths
• library configuration JSON
• user avatar data

To help others, I have prepared a ZIP file with the full migration procedure and helper scripts.

The ZIP includes:

README_ES.md  → Spanish guide
README_EN.md  → English guide
scripts/      → helper scripts used during the migration

 

The guide explains how to:

• restore the Emby backup on Linux
• convert Windows paths to Linux paths
• fix posters, fanart and metadata images
• fix library configuration paths
• restore user avatars
• validate SQLite databases
• configure systemd so Emby waits for NFS mounts before starting

Please make sure to stop Emby and backup all .db files before running any script.

Hope this helps anyone migrating from Windows/SMB to Linux/NFS.

 

emby_windows_to_linux_migration_forum_pack.zip