YouTrack Server 2022.3 Help

Migrate from Server to Cloud

This page provides instructions for migrating from a self-hosted YouTrack Server installation to a YouTrack Cloud instance hosted by JetBrains. When you perform this type of migration, we assume that:

  • You want to migrate all data from your YouTrack Server installation to a YouTrack Cloud instance.

  • You want to overwrite the YouTrack Cloud database with the data from your YouTrack Server installation.

  • You plan to retire your Server installation and work exclusively with the YouTrack Cloud instance or use the Server installation for another purpose.

As YouTrack Cloud is hosted, supported, and maintained by JetBrains, users do not have access to the hosting machines and services. That is, you cannot perform the complete migration yourself. Instead, you must send a migration request to YouTrack support team and provide required data.

If you want to just import issues from your YouTrack Server installation to your YouTrack Cloud instance without overwriting existing data, see Import from YouTrack.

Special Considerations for External Hub Installations

YouTrack Cloud uses a built-in Hub service for user authentication and access management. The option to connect to an external Hub service is not supported for YouTrack Cloud. That is: If your current YouTrack Server installation is connected to an external Hub service for authentication and authorization, you will need to separately prepare the Hub database for migration as well. Basically, you will need to provide the most recent valid backup of external Hub database.

As YouTrack Cloud does not support connection to an external Hub service, the following features will not be available in your new YouTrack Cloud instance:

  • Upsource Integration

  • Commit Widgets (Dashboard)

  • Review Widgets (Dashboard)

Requesting Migration from YouTrack Server to YouTrack Cloud

The YouTrack support team at JetBrains provides technical support for your YouTrack Cloud instance. When you migrate from YouTrack Server to YouTrack Cloud, the support team performs the migration for you.

To prepare for the migration:

  1. If you do not already have a registered instance, sign up for YouTrack Cloud.

  2. Make sure that your YouTrack Cloud instance has an active subscription. The number of users and storage limits supported by your YouTrack Cloud plan should be equal to or greater than your current license for YouTrack Server. Check your plan here.

  3. Create a backup of your YouTrack Server database:

    • Open the Administration > Database Backup page.

    • Click the Backup database now button.

    • Click the link to download the backup file.

  4. If you use an external Hub service, create and download a backup copy of your Hub database. For instructions, refer to the Hub documentation.

  5. Send us a request to migrate the database to your YouTrack Cloud instance.

    • Attach the backup of your YouTrack Server database.

    • If applicable, attach the backup of your external Hub database.

    • Provide the URL of your YouTrack Cloud instance.

For security purposes, the YouTrack support team asks you to confirm the email address that was used to register the YouTrack Cloud instance. If you used a different email address to request migration, send a confirmation email from the registration address.

When the support team receives the confirmation email, they migrate the data to your YouTrack Cloud instance and notify you when the operation is complete.

Last modified: 29 November 2022