# Is there any more in depth guide on how to configure Jira project import? **URL:** \ **Category:** Self hosted Taiga\ **Tags:** docker\ **Created:** [March 8, 2023, 1:32am UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848 "2023-03-08T01:32:46Z")\ **Posts on this page:** 19\ **Page:** 1
**Author:** ![RT-AP](https://avatars.discourse-cdn.com/v4/letter/r/839c29/32.png) [@RT-AP](https://community.taiga.io/u/RT-AP)\ **Post date:** [March 8, 2023, 1:32am UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/1 "2023-03-08T01:32:46Z")
I have a recent version of self hosted jira and self hosted Taiga I’m trying to migrate to. I’m looking at [taiga-docker/README.md at master · taigaio/taiga-docker · GitHub](https://github.com/taigaio/taiga-docker/blob/master/README.md) and [Migrate from Jira to Taiga](https://community.taiga.io/t/migrate-from-jira-to-taiga/164) The docker guide recommends configuring docker-compose.yml ```auto ENABLE_JIRA_IMPORTER: "True" JIRA_IMPORTER_CONSUMER_KEY: "consumer-key-from-jira" JIRA_IMPORTER_CERT: "cert-from-jira" JIRA_IMPORTER_PUB_CERT: "pub-cert-from-jira" ``` what are JIRA\_IMPORTER\_CONSUMER\_KEY?JIRA\_IMPORTER\_CERT?JIRA\_IMPORTER\_PUB\_CERT? I tried grepping through the source code (config.py) but couldn’t find any clues ```python ENABLE_JIRA_IMPORTER = os.getenv('ENABLE_JIRA_IMPORTER', 'False') == 'True' if ENABLE_JIRA_IMPORTER: IMPORTERS["jira"] = { "active": True, "consumer_key": os.getenv('JIRA_IMPORTER_CONSUMER_KEY'), "cert": os.getenv('JIRA_IMPORTER_CERT'), "pub_cert": os.getenv('JIRA_IMPORTER_PUB_CERT') } ``` was all I found and I couldn’t find where/how those variables were used. Are they related to oauth client id/client secret in jiras Application link mentioned in the jira migration link above ? ---
**Author:** ![TaigaTeam](https://dub1.discourse-cdn.com/flex017/user_avatar/community.taiga.io/taigateam/32/21_2.png) [@TaigaTeam](https://community.taiga.io/u/TaigaTeam)\ **Post date:** [March 8, 2023, 8:51am UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/2 "2023-03-08T08:51:09Z")
---
**Author:** ![david.barragan](https://dub1.discourse-cdn.com/flex017/user_avatar/community.taiga.io/david.barragan/32/293_2.png) [@david.barragan](https://community.taiga.io/u/david.barragan)\ **Post date:** [March 8, 2023, 11:42am UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/3 "2023-03-08T11:42:44Z")
Hi @RT-AP These parameters are used to authenticate request to the Jira API (using OAuth1) You can follow the source code, from the taiga API to the jira client: - [taiga-back/api.py at main · kaleidos-ventures/taiga-back · GitHub](https://github.com/kaleidos-ventures/taiga-back/blob/main/taiga/importers/jira/api.py#L38-L39) - [taiga-back/api.py at main · kaleidos-ventures/taiga-back · GitHub](https://github.com/kaleidos-ventures/taiga-back/blob/main/taiga/importers/jira/api.py#L103-L129) - [taiga-back/common.py at main · kaleidos-ventures/taiga-back · GitHub](https://github.com/kaleidos-ventures/taiga-back/blob/main/taiga/importers/jira/common.py#L88-L100) As you can see, these are the parameters needed to connect to the self-hosted jira instance. To generate for your jira instance, you can follow this steps: [Taiga: Importers](https://docs.taiga.io/importers.html#_jira) Regards ---
**Author:** ![RT-AP](https://avatars.discourse-cdn.com/v4/letter/r/839c29/32.png) [@RT-AP](https://community.taiga.io/u/RT-AP)\ **Post date:** [March 10, 2023, 10:29pm UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/4 "2023-03-10T22:29:55Z")
thanks @david.barragan so consumer\_key is oath1 consumer\_key. But I can’t seem to find a lot about it googling for oauth1 and consumer\_key. Is it just an arbitrary identifier for the client? Also does the public/private key data need to be added to jira configuration somewhere in addition to being configured in taiga? ---
**Author:** ![david.barragan](https://dub1.discourse-cdn.com/flex017/user_avatar/community.taiga.io/david.barragan/32/293_2.png) [@david.barragan](https://community.taiga.io/u/david.barragan)\ **Post date:** [March 13, 2023, 4:30pm UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/5 "2023-03-13T16:30:46Z")
Yes, is an arbitrary identifier between taiga and jira instance. This tutorial explains better the process (I hope) [https://developer.atlassian.com/cloud/jira/platform/jira-rest-api-oauth-authentication/](https://developer.atlassian.com/cloud/jira/platform/jira-rest-api-oauth-authentication/) check especially step 2. The public key should be configured in the Jira instance too with the consumer key when you create the “incomming link” (step 5 and 6 [Migrate from Jira to Taiga](https://community.taiga.io/t/migrate-from-jira-to-taiga/164)). 1. ![image](https://europe1.discourse-cdn.com/flex017/uploads/taiga/original/1X/7619f47e5edb7d1fb28f33c17e71727257e9643c.png) 1. use your consumer key and your public key ![image](https://europe1.discourse-cdn.com/flex017/uploads/taiga/original/1X/acd5e83b9aaaef1f02516de6d384a49cdb0c7ae5.png) ---
**Author:** ![RT-AP](https://avatars.discourse-cdn.com/v4/letter/r/839c29/32.png) [@RT-AP](https://community.taiga.io/u/RT-AP)\ **Post date:** [March 15, 2023, 4:28am UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/6 "2023-03-15T04:28:16Z")
Thanks I did add volumes: - taiga-static-data:/taiga-back/static - taiga-media-data:/taiga-back/media - ./taiga-gateway-nginx-https-certs/jira-self-singed-cert-chain.apcon.cer:/usr/local/share/ca-certificates/jira-self-singed-cert-chain.apcon.cer to taiga-back/taiga/async to fix the ssl issues since jira uses a self signed cert but then it successfully added and showed me the projects to import and the users to map. Now the only problem is it tells me it might take a while to import the Project and never does import it. Any ideas what might be wrong? ---
**Author:** ![david.barragan](https://dub1.discourse-cdn.com/flex017/user_avatar/community.taiga.io/david.barragan/32/293_2.png) [@david.barragan](https://community.taiga.io/u/david.barragan)\ **Post date:** [March 15, 2023, 7:44am UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/7 "2023-03-15T07:44:27Z")
The import is an asynchronous task. Try to review the logs of the celery worker (taiga-async service) that is responsible for performing these tasks. ```auto docker compose logs taiga-async ``` or the backend ```auto docker compose logs taiga-back ``` And remember this: > Important notice about Jira releases and Taiga compatibility > > - Taiga support Jira releases up to 8.3.5. It has been tested and should work out of the box. > - Taiga might support Jira releases from 8.3.5 to 8.5.x. Most probably it works. > - Taiga does not support Jira releases from 8.6. ---
**Author:** ![RT-AP](https://avatars.discourse-cdn.com/v4/letter/r/839c29/32.png) [@RT-AP](https://community.taiga.io/u/RT-AP)\ **Post date:** [March 15, 2023, 8:56am UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/8 "2023-03-15T08:56:59Z")
Its jira version 8.02 ```plaintext "-" taiga-docker-taiga-async-1 | [2023-03-15 08:52:34,275: ERROR/MainProcess] Received unregistered task of type 'taiga.importers.jira.tasks.import_project'. taiga-docker-taiga-async-1 | The message has been ignored and discarded. taiga-docker-taiga-async-1 | taiga-docker-taiga-async-1 | Did you remember to import the module containing this task? taiga-docker-taiga-async-1 | Or maybe you're using relative imports? taiga-docker-taiga-async-1 | taiga-docker-taiga-async-1 | Please see taiga-docker-taiga-async-1 | http://docs.celeryq.org/en/latest/internals/protocol.html taiga-docker-taiga-async-1 | for more information. taiga-docker-taiga-async-1 | taiga-docker-taiga-async-1 | The full contents of the message body was: taiga-docker-taiga-async-1 | b'\x80\x04\x95"...\x18https://jira.apcon.cloud\x94}\x94(\x8c\x0caccess_token\x94...\x94\x8c\x13access_token_secret\x94...\x94\x8c\x08key_cert\x94X\...\x00-----BEGIN PRIVATE... (3373b) taiga-docker-taiga-async-1 | Traceback (most recent call last): taiga-docker-taiga-async-1 | File "/opt/venv/lib/python3.7/site-packages/celery/worker/consumer/consumer.py", line 581, in on_task_received taiga-docker-taiga-async-1 | strategy = strategies[type_] taiga-docker-taiga-async-1 | KeyError: 'taiga.importers.jira.tasks.import_project' ``` ---
**Author:** ![david.barragan](https://dub1.discourse-cdn.com/flex017/user_avatar/community.taiga.io/david.barragan/32/293_2.png) [@david.barragan](https://community.taiga.io/u/david.barragan)\ **Post date:** [March 15, 2023, 1:20pm UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/9 "2023-03-15T13:20:46Z")
This is the error: ```plaintext taiga-docker-taiga-async-1 | [2023-03-15 08:52:34,275: ERROR/MainProcess] Received unregistered task of type 'taiga.importers.jira.tasks.import_project'. ``` This is because the jira importer module is not configure properly. It seems that it is only enabled on the taiga-front service but not on the other taiga-back and taiga-async services. Edit your docker-compose.yml and set this ```yml version: "3.5" x-environment: &default-back-environment # # (...) # # Jira importer ENABLE_JIRA_IMPORTER: "True" JIRA_IMPORTER_CONSUMER_KEY: "paste_your_consumer-key_here" JIRA_IMPORTER_CERT: "paste_the_content_of_your_private_key_file_here" JIRA_IMPORTER_PUB_CERT: "paste_the_content_of_your_public_key_file_here" # # (...) # services: # # (...) # taiga-front: image: taigaio/taiga-front:latest environment: # # (...) # ENABLE_JIRA_IMPORTER: "true" networks: - taiga # # (...) # ``` ![image](https://europe1.discourse-cdn.com/flex017/uploads/taiga/original/1X/19e7d2bdea7e22d5fd1f27e1e72bfec6aeae33be.png) ![image](https://europe1.discourse-cdn.com/flex017/uploads/taiga/original/1X/8afbef036669b5a8fdd5e02c858befad50b17947.png) So now, when you initialize the instance and check the taiga-async logs, you should see the task that is responsible for processing the Jira imports loaded (likd in the image below). ![image](https://europe1.discourse-cdn.com/flex017/uploads/taiga/original/1X/a9dac314856bb68bbb38e7ac28d32193105df32c.jpeg) If you’ve made it this far, try importing the project again. ---
**Author:** ![RT-AP](https://avatars.discourse-cdn.com/v4/letter/r/839c29/32.png) [@RT-AP](https://community.taiga.io/u/RT-AP)\ **Post date:** [March 15, 2023, 4:40pm UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/10 "2023-03-15T16:40:01Z")
thanks that fixed it. I got the sample project imported. I only had it configured for taiga-back not the shared default-back-environment. [GitHub - kaleidos-ventures/taiga-docker](https://github.com/kaleidos-ventures/taiga-docker/) should probably update their README since they suggest it only on `taiga-back` ---
**Author:** ![david.barragan](https://dub1.discourse-cdn.com/flex017/user_avatar/community.taiga.io/david.barragan/32/293_2.png) [@david.barragan](https://community.taiga.io/u/david.barragan)\ **Post date:** [March 15, 2023, 5:18pm UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/11 "2023-03-15T17:18:07Z")
Great!!! 🎉 You are absolutely right, the configuration guide is somewhat confusing about where to configure the plugins and importers. We’ll change it to be clearer. Thanks. ---
**Author:** ![RT-AP](https://avatars.discourse-cdn.com/v4/letter/r/839c29/32.png) [@RT-AP](https://community.taiga.io/u/RT-AP)\ **Post date:** [March 15, 2023, 5:56pm UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/12 "2023-03-15T17:56:27Z")
While it seems to work with stories/links/etc sadly instead of comments its gives Development: {summaryBean=com.atlassian.jira.plugin.devstatus.rest.SummaryBean@746654b1[summary={pullrequest=com.atlassian.jira.plugin.devstatus.rest.SummaryItemBean@5e52f67f[overall=PullRequestOverallBean{stateCount=0, state=‘OPEN’, details=PullRequestOverallDetails{openCount=0, mergedCount=0, declinedCount=0}},byInstanceType={}], build=com.atlassian.jira.plugin.devstatus.rest.SummaryItemBean@465cf35b[overall=com.atlassian.jira.plugin.devstatus.summary.beans.BuildOverallBean@f7414e1[failedBuildCount=0,successfulBuildCount=0,unknownBuildCount=0,count=0,lastUpdated=,lastUpdatedTimestamp=],byInstanceType={}], review=com.atlassian.jira.plugin.devstatus.rest.SummaryItemBean@2be24d5a[overall=com.atlassian.jira.plugin.devstatus.summary.beans.ReviewsOverallBean@6495748f[stateCount=0,state=,dueDate=,overDue=false,count=0,lastUpdated=,lastUpdatedTimestamp=],byInstanceType={}], deployment-environment=com.atlassian.jira.plugin.devstatus.rest.SummaryItemBean@45f2856d[overall=com.atlassian.jira.plugin.devstatus.summary.beans.DeploymentOverallBean@6a0e422e[topEnvironments=,showProjects=false,successfulCount=0,count=0,lastUpdated=,lastUpdatedTimestamp=],byInstanceType={}], repository=com.atlassian.jira.plugin.devstatus.rest.SummaryItemBean@53bf5aa8[overall=com.atlassian.jira.plugin.devstatus.summary.beans.CommitOverallBean@1cc16d5c[count=0,lastUpdated=,lastUpdatedTimestamp=],byInstanceType={}], branch=com.atlassian.jira.plugin.devstatus.rest.SummaryItemBean@4dc95a44[overall=com.atlassian.jira.plugin.devstatus.summary.beans.BranchOverallBean@55ce6ee1[count=0,lastUpdated=,lastUpdatedTimestamp=],byInstanceType={}]},errors=,configErrors=], devSummaryJson={“cachedValue”:{“errors”:,“configErrors”:,“summary”:{“pullrequest”:{“overall”:{“count”:0,“lastUpdated”:null,“stateCount”:0,“state”:“OPEN”,“details”:{“openCount”:0,“mergedCount”:0,“declinedCount”:0,“total”:0},“open”:true},“byInstanceType”:{}},“build”:{“overall”:{“count”:0,“lastUpdated”:null,“failedBuildCount”:0,“successfulBuildCount”:0,“unknownBuildCount”:0},“byInstanceType”:{}},“review”:{“overall”:{“count”:0,“lastUpdated”:null,“stateCount”:0,“state”:null,“dueDate”:null,“overDue”:false,“completed”:false},“byInstanceType”:{}},“deployment-environment”:{“overall”:{“count”:0,“lastUpdated”:null,“topEnvironments”:,“showProjects”:false,“successfulCount”:0},“byInstanceType”:{}},“repository”:{“overall”:{“count”:0,“lastUpdated”:null},“byInstanceType”:{}},“branch”:{“overall”:{“count”:0,“lastUpdated”:null},“byInstanceType”:{}}}},“isStale”:false}} Any ideas on how to fix it? ---
**Author:** ![david.barragan](https://dub1.discourse-cdn.com/flex017/user_avatar/community.taiga.io/david.barragan/32/293_2.png) [@david.barragan](https://community.taiga.io/u/david.barragan)\ **Post date:** [March 15, 2023, 7:10pm UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/13 "2023-03-15T19:10:37Z")
O\_o No Idea, It’s the first time I see this error ☹ Maybe you could disable some plugin in Jira, although I don’t know if that could be the cause. ---
**Author:** ![RT-AP](https://avatars.discourse-cdn.com/v4/letter/r/839c29/32.png) [@RT-AP](https://community.taiga.io/u/RT-AP)\ **Post date:** [March 15, 2023, 7:49pm UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/14 "2023-03-15T19:49:29Z")
I think it might be caused by [[JSWSERVER-16544] Development Field is REST API / webhook doesn't return result in the correct format - Create and track feature requests for Atlassian products.](https://jira.atlassian.com/browse/JSWSERVER-16544) but sadly that doesnt list solutions/workarounds ---
**Author:** ![RT-AP](https://avatars.discourse-cdn.com/v4/letter/r/839c29/32.png) [@RT-AP](https://community.taiga.io/u/RT-AP)\ **Post date:** [March 15, 2023, 8:32pm UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/15 "2023-03-15T20:32:07Z")
Also it seems to show each project twice for the jira Project and the jira Board, I’m guessing its better import the Project not the board? Sorry I haven’t used jira much, do the projects have more stuff besides the board? ---
**Author:** ![david.barragan](https://dub1.discourse-cdn.com/flex017/user_avatar/community.taiga.io/david.barragan/32/293_2.png) [@david.barragan](https://community.taiga.io/u/david.barragan)\ **Post date:** [March 15, 2023, 10:19pm UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/16 "2023-03-15T22:19:54Z")
I haven’t used Jira much either (for an obvious reason xD). Checking the importer code in Taiga I see that users, epics, user stories, task and issues are imported. There are two types, [normal](https://github.com/taigaio/taiga-back/blob/master/taiga/importers/jira/normal.py#L33) (for project) and [agile](https://github.com/taigaio/taiga-back/blob/master/taiga/importers/jira/agile.py#L34) (for boards). Try both, it’s probable that “project” give less errors. ---
**Author:** ![RT-AP](https://avatars.discourse-cdn.com/v4/letter/r/839c29/32.png) [@RT-AP](https://community.taiga.io/u/RT-AP)\ **Post date:** [March 16, 2023, 12:32am UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/17 "2023-03-16T00:32:39Z")
For some reason Board seems to do better for me. It gets more stuff sorted in sprints. And I dont see anything missing What does the “Links with Do you want to keep the link of each item with the original card?” do? ---
**Author:** ![david.barragan](https://dub1.discourse-cdn.com/flex017/user_avatar/community.taiga.io/david.barragan/32/293_2.png) [@david.barragan](https://community.taiga.io/u/david.barragan)\ **Post date:** [March 16, 2023, 7:44am UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/18 "2023-03-16T07:44:39Z")
It’s to maintain a link to the item in Jira. ---
**Author:** ![RT-AP](https://avatars.discourse-cdn.com/v4/letter/r/839c29/32.png) [@RT-AP](https://community.taiga.io/u/RT-AP)\ **Post date:** [March 17, 2023, 8:57pm UTC](https://community.taiga.io/t/is-there-any-more-in-depth-guide-on-how-to-configure-jira-project-import/848/19 "2023-03-17T20:57:18Z")
actually I was wrong looks like project import is better.