Migrate from InCloud to Standalone

To export your YouTrack InCloud database:

tip

Requires permissions: Low-level Admin Read

1. In YouTrack InCloud, open the Administration > Database Export page.

2. Click the Update export file button.

3. When the export file has finished updating, click the Download link.

   • The backup file is saved to your local directory.

To migrate to YouTrack Standalone with an MSI or ZIP distribution:

1. Download and install the MSI or ZIP distribution. Follow the standard installation guide up to the step where the web-based Configuration Wizard opens in your default browser.

   • For the MSI installation guide, see MSI Installation.

   • For the ZIP installation guide, see ZIP Installation.

2. In the Configuration Wizard, click Upgrade.

3. On the Select Upgrade Source page, select the database backup that you exported from your YouTrack InCloud instance in the previous procedure.

4. Click the Next button.

   • The Confirm Settings page opens.

   • The Base URL displays the URL of your YouTrack InCloud instance.

5. Change the Base URL setting to the URL of your YouTrack Standalone server.

6. Click the Upgrade button.

   • The configuration is applied to your YouTrack Standalone server.

   • The YouTrack service starts using the license that is associated with your YouTrack InCloud instance. You are notified that the license can only be used for YouTrack InCloud.

7. Click the link to access the Global Settings page.

8. Enter the License User Name and License Key for YouTrack Standalone.

9. Click the Save button.

   • Your YouTrack server runs using the updated license.

   • The data from your YouTrack InCloud instance is available for use on your YouTrack Standalone server.

To migrate to YouTrack Standalone with a JAR distribution:

1. Download the JAR distribution and upload it to your server.

2. Before you run the YouTrack service, extract the data from your YouTrack InCloud instance to the data directory of your standalone installation.

   • Check the data directory of your standalone installation and verify that it is empty. The default location of the database is in the teamsysdata folder in the home directory of the user account that runs YouTrack. If there are any files or folders in this directory, delete them.

   • Extract the contents of the database backup file to your data directory. After extraction, the data directory contains two folders: hub and youtrack.

3. Run YouTrack Standalone from the command line. Use the following Java start parameters to configure the server:

   Parameter	Description
   jetbrains.youtrack.baseUrl	Set the Base URL property to the base URL of your YouTrack Standalone server.
   jetbrains.youtrack.licenseName	Set the name of your YouTrack license to the name of your YouTrack Standalone license.
   jetbrains.youtrack.licenseKey	Set the license key of the YouTrack license to your license key for YouTrack Standalone.

   For example:

   java -Xmx1g -XX:MaxMetaspaceSize=250m -Djava.awt.headless=true
   -Djetbrains.youtrack.baseUrl="http://www.mystandaloneserver.com:[port]
   -Djetbrains.youtrack.licenseName="YouTrack Free Pack User"
   -Djetbrains.youtrack.licenseKey="fa210d1d87408e18c6cfb9e09991aa5f9781410fcf660e47a366fcf83d5d25085e4b41e7ffd54256424e32a3aac1d5ec7464d98421b1a3068c8642279d0e0d85cb2e569b0f20fc5174331e40fe2e09f4291d14d8058015a71ef2ab64c2847fc82f71e0038b4ebd53b7e0e4d6ec7348fe0a0598d8b78f253914aa4959a59eb997"
   -jar youtrack-<version>.jar [host:]<port>[/contextPath] [config file path]

   • Your YouTrack server runs using the updated base URL and license.

   • The data from your YouTrack InCloud instance is available for use on your YouTrack Standalone server.

4. Once you have verified that everything works as expected, remove the custom start parameters from the command that you use to start the server.