Sysadmins of the North
Don't forget to share this post!

Umbraco doesn’t like users with MySQL databases

Umbraco 6.0.2 fails when using MySQL, because Umbraco has changed their database layer/logic, breaking MySQL support. Because SqlCe is deprecated by Microsoft it is best to use SQL Server instead as your Umbraco database back-end.

This issue was first spotted in version 6.0.0RC, and reported in the Umbraco development group on Google Groups.

This post explains the exact problem. Excuse the rambling and incoherent writing 😉

However I fear that the problems with Mysql are just beginning with the transition to PetaPoco. The main problems have to do with case-sensitivity on mysql.

Consider the following facts:

This means that Umbraco will work perfectly well on a windows mysql installation but not on a mysql installation running on a unix server. I have confirmed that this is the case with 6.0RC.


PetaPoco created the table “umbracoUser” but MySqlHelper expects “UMBRACOUSER” to exist, and that causes Umbraco to crash.

I believe it will be necessary to remove the uppercasing on the Mysql ISqlHelper and rewrite all sql statements to proper casing in order to make 6RC run on a case sensitive mysql installation. This is a lot of work but I think it’s better to bite the bullet and get it over with once and for all.

I also believe that Umbraco needs to support mysql databases on unix servers as these are very popular on low-cost .Net hosting plans.

Well… The problem lies in SQL statements like (file umbraco.datalayerSqlHelpersMySqlSqlTotal.sql):

CREATE TABLE umbracoRelation 

CREATE TABLE cmsDocument 
CREATE TABLE umbracoLog 

Or in umbraco.datalayerSqlHelpersMySqlSqlVersion4_Upgrade.sql:

INSERT INTO umbracoNode (id, trashed, parentID, nodeUser, level, path, sortOrder, uniqueID, text, nodeObjectType, createDate)

One and the same table, written in different casing.

This may interest you:   Convert MySQL MyISAM tables to InnoDB

Reported issues with Umbraco 6 and MySQL

Others also reported this to Umbraco: U4-1632 MySQL Database Setup – Table Names

There appears to be an issue when performing an initial installation when the DB is sitting on a Linux installation of MySQL.
This is due to inconsistancies in naming conventions when referencing the tables. A default Linux installation of MySQL is case sensitive and the installation script sometimes refers to table names using uppercase.

One comment by Niels Hartvig to the issue is:

We don’t have any plans to prioritise this in any foreseeable future as there’s a valid workaround and MySQL is only used by a small minority of Umbraco users.

But hé, “only” 16% uses MySQL as their database backend, according to Umbraco’s Twitter poll.

MySQL server case-insensitive configuration settings

Mister Niels Hartvig references the MySQL settings lower_case_table_names and lower_case_file_system to fix their own wrongdoings in the past.

This is not the first bug Umbraco introduces in new releases… Mister Niels Hartvig clearly hasn’t considered the consequences of setting MySQL lower_case_table_names=1 and lower_case_file_system=1 on already running MySQL database servers. Suppose an user has two or three MySQL tables:

  1. Users
  2. users
  3. uSeRs

after changing the lower_case settings, they’ll be treated the as the same, which will only cause problems.

This may interest you:   Like, Share, Follow & +1


Umbraco users with MySQL databases are left out in the bitter cold. Nice go Umbraco.

Of course you can use SqlCE as your database back-end for Umbraco. Please note that an SqlCe database is deprecated! Therefore Microsoft SQL Server is recommended.

Turns out not all my blog comments were migrated to Disqus and back successfully. On 2014/04/30 StephenPAdams placed a comment I don’t want to withheld from you.

Hi Jan,

I’ve ran into the same issue as yourself. But I went ahead and forked Umbraco 7.1.2 and have been slowly fixing some areas of the repositories where the casing was different from what was actually on the file system. In addition, I removed the requirement for lower case table names to be enabled. Earlier this morning my pull request was integrated into 6.2 and will eventually be merged up to 7.1.2. See revision:

Feel free to follow me on Twitter. I’ll be posting on my blog as I continue to make progress:

buy me a coffee
Buy Me A Coffee

About the Author Jan Reilink

My name is Jan. I am not a hacker, coder, developer, programmer or guru. I am merely a system administrator, doing my daily thing at Vevida in the Netherlands. With over 15 years of experience, my specialties include Windows Server, IIS, Linux (CentOS, Debian), security, PHP, WordPress, websites & optimization. Want to support me and donate? Use this link:

follow me on:

Leave a Comment:

Add Your Reply
Skip to content