Import from Redmine

This page provides instructions for importing issues from a Redmine instance to YouTrack with the Python Client Library.

Import Details

When you import issues from Redmine, be aware of the following mechanics:

The Redmine REST API does not support watchers and tags. These elements are not imported to YouTrack.
When you import work items from Redmine, the values that are stored in the SpentTime field are not imported to YouTrack. This data is derived from imported work items.

The Python script lets you import all issues from a source project at once. The target project is created automatically.

To import issues from a Redmine server to YouTrack:

In your Redmine instance, ensure that REST support is enabled: open Administration > Settings > Authentication tab and select the Enable REST web service check box.
Download the latest version of YouTrack's Python Client Library and unzip it.
Ensure that Python is installed in your system.
If needed, correct the default mapping file.

Run the script. The script supports two authentication options for Redmine: using login/password pair or using the API key. Thus, you can use either of them with the respective command:

To run import with API key authentication use -a option:

python redmine2youtrack.py -a api_key r_url y_url y_user y_password [project_id ...]

Parameter	Description
r_url	Redmine URL
api_key	Redmine API Key. Redmine API key can be found on your user account page.
y_url	YouTrack base URL
y_user	YouTrack user
y_password	YouTrack user's password
project_id	Redmine project identifier

To run import using login/password pair, use the following command:

python redmine2youtrack.py r_url r_user r_pass y_url y_user y_password [project_id ...]

Parameter	Description
r_url	Redmine URL
r_user	Redmine user
r_password	Redmine user's password
y_url	YouTrack base URL
y_user	YouTrack user
y_password	YouTrack user's password
project_id	Redmine project identifier

That's it.

If you run the script with -h option, then short help file will be displayed.

Last modified: 2 February 2017