3x-uiMigration
Migrate to 3x-ui from x-ui, between servers, or between 3x-ui versions.
Between servers
Moving to a new server is a database move:
Back up the old server
Copy the database (default /etc/x-ui/x-ui.db) and your certificates. See
Backup & restore.
Install 3x-ui on the new server
Use the same install method and a compatible version. See Installation.
Restore the database
Stop the panel, put the database in place, restore certificates, and start the panel. Update any IP/domain-specific settings.
Between 3x-ui versions
Within the same backend, upgrading is usually just re-running the installer or pulling a new image — the panel migrates its own database. Across major versions, read the release notes first and take a backup.
From x-ui
Importing an older x-ui panel's database directly into 3x-ui is not supported — the schemas differ. Install 3x-ui fresh and recreate inbounds/clients, exporting share links from the old panel as you go.
Always take a backup before any migration, and keep the old server running until you've verified the new one.