Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Cloud to server migration - usernames

I'm researching migration from Jira Cloud to Server.

When I restore the backup on servers, user end up with usernames like ug:03775bde-ca11-432b-8833-b3cedeadbeef. It appears there is no other username, they cannot log in with email either.

Is this correct? What is the common, recommended workaround to get them to work again, with human-friendly usernames?

2 answers

0 votes
Ollie Guan Community Leader Sep 29, 2020

Hi @Konrad Garus ,

Deprecation notice and migration guide for major changes to Jira Cloud REST APIs to improve user privacy.

Thanks. I know about it, but it doesn't really answer my question about migration to Server.

Hi @Konrad Garus 

Yes it's common as usernames are not applicable on Cloud Instance as they have been deprecated, so during migration from Cloud to Server, You will need to ensure that you define a username in the xml file rather than import it like that (although that method is rather complicated) else, you will see those alphanumeric string on the user. Another way you could go about this, is to create those users first using REST API on Jira Server. Jira Server will auto assign a username to those user. So during your import from Cloud to Server if the email address matches, Jira Server can pick up that user as an existing user.

@Prince Nyeche Thanks, this second option sounds intriguing. However, I could not get it to work. Restoring a backup always seems to completely replace my userbase, overwriting whatever I may have created before.

Can you elaborate on it a little? What exactly are the steps here?

Hi Konrad,

We are migrating from Cloud to Server and are having the same issues as you with the user names.

Can you please let me know how you ended up solving this?



@Ychambers sealite in our experience there are 3 reliable ways of migrating users:

  1. Use the Jira Cloud Migration Assistant (you can use it to migrate just the users (to be followed by XML site import), or users and data).
  2. Import the users with the XML site import - but then you must ensure they all have valid and unique email addresses.
  3. Ask Atlassian to import users and groups from a CSV file that you provide, then remove all users from the XML backup and do the site import.

See also:

It's getting complicated when you have external user directories - Jira Cloud doesn't support them, you'll have to edit your configuration or manipulate the XML/CSV files so  that they only have the internal directory. We ended up implementing our own custom tools to do this (I can't share them here as we're using them for commercial consulting).

Hope this helps.

Konrad Garus/Expium

Suggest an answer

Log in or Sign up to answer
Site Admin
Community showcase
Published in Jira

⏰ Day in the life of a Jira Admin!

Hello Community! We thoroughly enjoyed this just-for-fun conversation in the Jira Admin Group about what it's like to be a Jira Admin. For #JiraJuly, our talented designers created these graphics t...

77 views 1 7
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you