Database Configuration File

Before installing Omeka, users must edit their database configuration in the db.ini file. Replace the X's in the document with your MySQL database-specific information. You must have MySQL5 installed to use Omeka.

Required Fields

These fields must be filled in for any Omeka installation. Your hosting provider or system administrator should provide you with the correct values for each of these.

host

The location of your database. This is most commonly "localhost" but may vary between hosting providers and servers. Other common possibilities include "mysql" or "mysql.localdomain".

username

password

These are specific to your MySQL database, and often different from your FTP username and password.

dbname

Your database name. Shared hosts often will prefix these names with your username, sometimes resulting in a database name like username_databasename.

Additional Fields

These fields can usually be left untouched, but some installations or special situations may require their use.

prefix

The prefix field value is "omeka_" by default. To install more than one Omeka installation on the same database, change the prefix for each installation.

charset

This should almost never be changed from its default of "utf8". Only touch this setting if you are sure you know what you're doing.

port

MySQL servers usually use port 3306, and Omeka will use that port unless you specify something different here. Your hosting provider or server administrator will tell you if you need to use a different port.