Index: archiva-docs/src/site/apt/adminguide/databases.apt
===================================================================
--- archiva-docs/src/site/apt/adminguide/databases.apt	(revision 952898)
+++ archiva-docs/src/site/apt/adminguide/databases.apt	(working copy)
@@ -32,6 +32,8 @@
   By default the archiva and users databases are stored in the <<<databases>>> directory where Archiva is installed. To change the
   path, just edit all instances of the "DatabaseName" property in <<<conf/jetty.xml>>> (see below). 
 
+  <<Note:>> If you are using MySQL as your database, Archiva fails when the users database created is initially set to utf8 for the character encoding. As a workaround, set the database to utf8 encoding after it has been populated.
+
 +------+
 ...
 <New id="archiva" class="org.mortbay.jetty.plus.naming.Resource">