Note about permissions

To perform migration between InCloud and Standalone versions, you must have low-level system administrator permissions.

When you decide to migrate from YouTrack InCloud to the standalone YouTrack server, you have two options:

1. Move all YouTrack data to a brand-new YouTrack standalone installation, or (in rare cases) to an existing installation, but without preserving any data on this standalone YouTrack.
2. Add issues from YouTrack InCloud to an existing standalone installation.

Migrating to a New YouTrack Standalone Installation

To migrate data from YouTrack InCloud to standalone version:

1. In YouTrack InCloud, open Administration > Database Export page.
2. Click 'Update database export file' link.
3. Download updated file. Filename format is: <date and time of update>.tar.gz
4. Copy the downloaded tar.gz file to the YouTrack standalone server machine.
5. Stop YouTrack standalone server instance.
6. Delete the content of the database location directory to ensure that it is empty.
   Please read before proceeding!

   • When you delete the content of database location, all your current YouTrack data will be lost including the license information. You will need to re-enter your license key after YouTrack is started with the database from YouTrack InCloud, so please keep the information at hand.
   • The baseURL parameter is stored in the database as well, that is: You will have to correct the baseURL stored in your InCloud database.
   By default, the database is located in the 'teamsysdata' folder in the home directory of a user account, which starts YouTrack. You can change default database location, for more details please refer to the Changing Database Location page.
7. Extract the downloaded tar.gz file to your database location. After extracting the database location directory should contain only blobs folders and .xd files.
8. Start YouTrack server. YouTrack will try to open the Setup page, but as long as your database contain the URL of your YouTrack InCloud instance, you will have to change it.
9. Correct the baseURL of your YouTrack server:
   1. In the address line of your browser type in the direct link: http:/localhost:<your youtrack port>/login You should be navigated to the Login page of your YouTrack server.
   2. Log in with your 'root' account (or any other account with low-level administrator permissions). Please note, that after logging in, you will be once again redirected to the incorrect page. Please don't panic, you still need to perform one more step before the baseURL will be changed.
   3. Now open http:/localhost:<your youtrack port>/setup — you should be navigated to the Setup page.
   4. In the baseURL field, specify the correct URL for your server.
10. On the Setup page, provide your license key to YouTrack Standalone, or select the Free pack. For more details please refer to the Initial Setup page description.
    Free Pack License Information

    If you don't have a license key and on your YouTrack InCloud instance you had less then 10 users, you can use the following license key to enable the YouTrack Free Pack:

    • License User Name : YouTrack Free Pack User
    • License Key : fa210d1d87408e18c6cfb9e09991aa5f9781410fcf660e47a366fcf83d5d25085e4b41e7ffd54256424e32a3aac1d5ec7464d98421b1a3068c8642279d0e0d85cb2e569b0f20fc5174331e40fe2e09f4291d14d8058015a71ef2ab64c2847fc82f71e0038b4ebd53b7e0e4d6ec7348fe0a0598d8b78f253914aa4959a59eb997

Adding YouTrack InCloud Data to Existing YouTrack Standalone

In case of migrating YouTrack InCloud data to an existing standalone server, while preserving existing data on this standalone installation, you should use YouTrack REST API to import data from one YouTrack server to another.

We provide the Python Client Library, which uses existing REST API, with a ready-to-use script for migrating issues from one YouTrack server to another. Please refer to the detailed description of the script for more information.