Installing under MySQL

The terms of the GPL license preclude us from distributing a version of mojoPortal configured to depend on the MySQL Connector for .NET as this would require mojoPortal also to be licensed under the GPL. Note that the GPL places no restriction on how end users can use the software but only the terms under which it can be distributed. Fortunately the architecture of mojoPortal is such that the only code with a dependency on the MySQL Connector is contained in a separate library and we can release this library (the MySQL Data Layer for mojoPortal) under the GPL with the only inconvenience being that you the end user must install it in place of the data layer that ships with mojoPortal since we can't distribute mojoPortal as an application with the .NET Connector for MySQL.

What this means is that if you want to use MySQL with mojoPortal, you should:

  1. Download the MS SQL release files and the MySQL Data Layer for mojoPortal from our github releases page and extract the zip files on your local machine.
  2. Then you should copy the DLLs from the MySql data layer download into the /bin folder of the MS SQL files overwriting any files by the same name.
  3. You should also copy the contents of the Setup folder in the MySql Data Layer package into the /Setup folder beneath your site.

Note that the instructions on this page are for using the pre-compiled deployment files, if you are working with the source code see setting the data layer reference in Visual Studio.

Setting up your MySQL database

You should have MySQL 5.6.20 or newer installed. It may work with older versions but we have not tested it.

Create a database and a user with full permission to the database. Enter the connection string in the web.config then navigate to yoursiteroot/Setup/Default.aspx Your connection string will be something like this:


If you get an error: Unable to connect to any of the specified MySQL hosts
See here

make sure your /etc/mysql/my.conf file does not have the "skip-networking" feature enabled. This is the default in some installations and disables tcp/ip connections.

If you have any difficulties please post messages in the forums and I will try to respond as soon as possible.

Additional Resources:

You can download MySQL for Linux or Windows here.

Some GUI tools for MySQL are MySQL WorkbenchSQLYog and Aqua Data Studio.