Migrating users between servers

Streams Manager allows you to migrate your users between different media servers including heterogeneous migration (i.e. Plex to Emby and vice versa) with a single click of a button. This can be useful is you are migrating Plex servers or providers. This option is available on the Servers panel by clicking the action menu button next to the server from which you wish to migrate the users (source server). Then you will be prompted to select the target server where your users will be moved to. Once you click OK, Streams Manager will initiate the migration process in the background and send you an email notification (System Message notification template must be enabled) when it is finished with results.

Both old and new servers must be already added to Streams Manager prior to initiating the migration. If you plan does not allow adding more servers because of plan limits, you will need to upgrade your plan to allow more servers.

Streams Manager will keep all the user data intact such payments, login information, etc.

User migration has a few things that you need to keep in mind:

  • New server must already be added to Streams Manager, Enabled must be turned ON as well as Allow new subscriptions. New server should have the same libraries and the old server and those libraries must be put into the same groups as the old server

  • Both source and target servers must support the same plans. This means that they must offer the same library groups that are already included on plans. For example, if one server has libraries assigned to "Premium 4K" group that are included on plans but the other does not, then the servers are not compatible

  • If your plans offer mobile downloads, Plex accounts tied to both servers must have Plex Pass and be configured like that in the Plex Accounts panel (Has Plex Pass switch must be set correctly). Similarly, Emby must have Premiere subscription and server marked as Has Emby Premiere

  • Each user on the source server must have an active subscription/payment where current date/time is between payment's start and end date/time

  • If both source and target server are on the same Plex account, invites will be accepted automatically and users can begin to use the new server immediately. Otherwise, users will get brand new invites they need to accept

  • If migrating between different server types (i.e. Plex to Emby), each user being migrated must have their Plex/Emby email populated

  • Process runs in the background slowly migrating one user every 30 seconds or so to avoid Plex API throttling and drawing attention from Plex. At the end of the process you will receive an email with the results

Once you receive an email with the results and if all users were not migrated, you may need to wait an hour and run another migration. Keep repeating these steps until all users are migrated.

Last updated