Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Unable to start Jira with "The database setup is not supporting utf8mb4" error

※ This article was updated on Oct 15, 2019. utf8mb4 is required for Jira 8.12 or later. ※ 

Unable to start Jira with "The database setup is not supporting utf8mb4" error.

This Knowledge Base article was written specifically for the Atlassian Server platform.


The following error message was displayed when start-up Jira Server.

Database: We've found an error in MySQL supported version!

The database setup is not supporting utf8mb4
See our documentation for more information on setting up MySQL 5.7.
 Screen Shot 2019-10-15 at 11.54.50.png


Since utf8mb4 is officially supported from JIRA 8.x and MySQL version 5.7

When the user selects Database Type MySQL 5.7+ in the setup wizard, dbconfig.xml automatically set database type to mysql57.


Screen Shot 2019-10-15 at 11.04.24.png


This dbconfig.xml configuration let Jira expect to use utf8mb4 Collation and Character.




Always backup your data before performing any modifications to the database.

Use utf8mb4

Please follow the below link and update the Database collation, character, and my.cnf .

Use utf8

  • Change database-type mysql57 to mysql in dbconfig.xml


Please follow the below link and update Database collation, character and my.cnf .


For a fresh copy of 7.6 there is not choice for MSQL 5.7+


You can set it manually in your dbconfig.xml

Yes but then it says that UTF8mb4 is unsupported.  It doesn't really matter anymore as server is going away and MySQL is not supported in DC.


Jira Server is going away?  When I didn't see any notice, do you have a link speaking of this deprecation? 

I am having big problems with my MySQL 5.7+, and my character set system is set to utf8, and when I change the dbconfig.xml via the configuration tool, it shoots me that error. " UTF8MB4 is unsupported".  If I change the file manually I am able to load everything without a problem.  I actually just opened a question on my issue. 

Thank you!

WOW. I thought the world new about this, in my communities that is the only conversations.  It was a big announcement from atlassian

Next year no new licenses, then product EOLs in 2024.   Only cloud and DC going forward.

If your company needs help with a migration to cloud or DC, please let me know as we can help.  


That link goes no where...and I will look more into this conversation.  

Thank you for the help!


Log in or Sign up to comment

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