YouTrack InCloud 2021.2 Help

Import from Redmine

YouTrack lets you connect to a Redmine instance and import projects, users, issues, and other entities from Redmine to YouTrack.

Prerequisites

Before you import projects from Redmine to YouTrack, check the following requirements:

  • Your Redmine installation allows remote API calls. To ensure that, open Administration > Settings > API tab in your Redmine, check the Enable REST web service option, and click Save.

    If your Redmine version is older than 4.10, the option to enable REST API support is located on the Settings > Authentication tab.

  • Your YouTrack and Redmine installations are accessible to inbound connections. Specifically, you need to make sure that your network doesn't block connections between your Redmine installation and YouTrack.

  • Your user account in Redmine has administrative permissions.

Import Details

If the Redmine database contains references to entities that do not already exist in YouTrack, they are created. The YouTrack user account that you use to run the import should have permissions to create all imported entities. We recommend that you use an account with a System Admin role or the Low-level Admin Write permission to run the import.

Here is the list of entities that are imported from Redmine and their mapping to YouTrack entities:

Entity in RedmineEntity in YouTrack
ProjectsProjects
UsersUsers
GroupsGroups
Project membersProject team members
IssuesIssues
WatchersWatchers
NotesComments
FilesAttachments
Project wiki pageKnowledge base article
Spent timeWork items
Custom fields, issue statuses, enumerations, issue categories, versions.Custom fields
Custom field valuesCustom field values

Set up an Import from Redmine

The setup wizard guides you through the setup process.

To connect to a Redmine instance:

  1. From the Administration menu, select Integrations > Imports.

  2. Click the New import button.

    • The New Import dialog opens.

    New Import dialog.
  3. Click Redmine.

    • The New Import from Redmine dialog opens.

    New Import from Redmine dialog.
  4. Enter values for the following settings:

    SettingDescription
    URLEnter the URL of the Redmine instance.
    TokenEnter the API access key from the admin account in Redmine.
    SSL key

    If your Redmine instance requires client SSL authentication, activate the Use SSL key for client authentication switch. You can then select the SSL key that identifies your YouTrack server from the list.

    The list only displays SSL keys that have already been imported into YouTrack. To learn how to generate and upload SSL keys, see SSL Keys.

  5. Click the Next button.

    • The next part of the configuration dialog opens.

    New Import from Redmine dialog step two.
  6. In the dropdown, select the projects that you need to import data from.

  7. Click the Start import button.

    • The import process starts.

    • When the import is finished, Import Status is updated.

    Redmine import status.
  8. If you want to learn more details about the import, click the Download import log button.

Default Custom Fields

The list of custom fields that are created in the target YouTrack project by default:

NameType
Statestate
Assigneeuser[1]
Estimationperiod
Spent timeperiod
Priorityenum[1]
Typeenum[1]
Fix versionsversion[*]
Due Datedate
Start Datedate
% Donestring
SubsystemownedField[1]

Delete the Import Configuration

When all your data is imported from Redmine to YouTrack, you can delete the import configuration.

When you delete the import configuration, Redmine entity IDs that are attached to imported issues are also removed. Projects, issues, users, and groups that were imported from the connected Redmine instance are not affected. If you delete the import settings and connect to the same Redmine instance, the issues are re-imported into existing projects with new issue IDs.

To edit an existing import configuration:

  1. From the Administration menu, select Integrations > Imports.

  2. In the list of configured imports, select the one you need to delete.

    Details sidebar

  3. Click the trash icon in the main toolbar of the page, or the Delete button in the right details sidebar.

  4. In the shown dialog, confirm the operation by clicking Delete.

    Confirm delete operation
    • The current import settings are removed.

    • All entities that are already imported remain in YouTrack.

Last modified: 21 May 2021