Supported Databases

Important

We do not recommend using SQLite in a production environment. It is supported by RhodeCode Enterprise for evaluation purposes.

Database Overview

Prior to installing RhodeCode Enterprise you should install and set up your database. This means carrying out the following tasks:

  1. Install the database software of your choice.
  2. Using the relevant instructions, create a user on that database to use with RhodeCode Enterprise.
  3. Create a database, granting that user read/write access.
  4. During RhodeCode Enterprise installation you will be prompted for these user credentials, enter them where appropriate. These credentials will be what RhodeCode Enterprise uses to read/write from the database tables.

Version Differences

RhodeCode Enterprise releases 2(Major).x(Minor).x(Bug Fix) and 3.x.x use different database schemas. Therefore, if you wish to run multiple instances using one database, you can only do so using the same Minor Release numbered versions. Though Bug Fix updates rarely have a database change, it is recommended to use identical RhodeCode Enterprise version numbers for multi-instance setups.

You can use the same database server to run multiple databases for differing version numbers, but you will need separate databases for each RhodeCode Enterprise version on that server. You can specify the database during installation, use the following example to configure the correct one.

Database type - [s]qlite, [m]ysql, [p]ostresql:
PostgreSQL selected
Database host [127.0.0.1]:
Database port [5432]:
Database username: rhodecode
Database password: somepassword
# Specify the database you with to use on that server
# for the RCE instance you are installing
Database name: example-db-name-for-2xx # The 2xx version database
Database name: example-db-name-for-3xx # The 3xx version database

Supported Databases

RhodeCode Enterprise supports the following databases. The recommended encoding is Unicode UTF-8.