Databases ​

Overview ​

When provisioning a new Forge server you may choose to install an App Server or a Database Server. You can then use the Forge dashboard to manage databases, users, and permissions.

Creating Servers With Databases ​

When creating a new server, you can select to install a supported database server:

• MySQL (8.0)
• MariaDB (10.6)
• MariaDB (10.11)
• PostgreSQL (12)
• PostgreSQL (13)
• PostgreSQL (14)
• PostgreSQL (15)
• PostgreSQL (16)

As part of the provisioning process, Forge will automatically install the selected database server and create a default forge database, forge user, and a secure, randomly-generated password. The database password will be shown upon creating the server alongside the root password. These passwords will also be emailed to you.

Installing Databases Later ​

If you later decide to that you need to install a database on your server, you can do so through the server's Databases management tab. Once installed, you will then be able to manage your database via Forge.

Changing the Root / Forge Database Password ​

To reset the root and forge database user passwords, you may use the password reset functionality provided by Forge's Databases management tab.

Connecting To Databases Via A GUI Client ​

By default, database connections require SSH key authentication and are not able to be accessed using passwords. Therefore, when using a GUI database client to connect to your Forge database, you will need to use SSH authentication.

When selecting the SSH key to use during authentication, ensure that you select your private SSH key. For example, when using the TablePlus database client:

Using the Database Connection URL ​

Some clients, such as TablePlus, allow you to connect to a database via a connection URL. Forge automatically generates this connection URL for you and you can use it to connect to your database. Note that the password is not included in this URL, so you should provide your password manually within your database client's GUI.

Managing Your Databases Within Forge ​

For servers running MySQL, MariaDB, and PostgreSQL, Forge offers some advanced features which allows it to manage your databases and database users easily. We'll discuss these features below.

Creating Databases ​

You can create a new database through the server's Database tab within Forge. At a minimum, you must supply the name of your new database. The forge user will be able to access the database automatically.

Syncing Databases ​

For consistency, you should use Forge to manage your databases and database users. However, if you created databases outside of the Forge dashboard, you can manually sync them into the Forge dashboard using the Sync Databases button on your Forge database management panel.

When syncing databases, some database names that are reserved by the database engine will not be synced, including:

• mysql
• information_schema
• peformance_schema
• sys
• postgres
• template0
• template1

Creating Database Users ​

You can create extra database users through the Forge dashboard's database panel. To do so, you'll need to provide the username, password, and select the databases that the new user can access.

Upgrading Databases ​

Forge does not provide the ability to upgrade your database server software automatically. If you wish to upgrade your database server, you will need to complete this manually.

Circle Permissions ​

You may grant a circle member authority to create and manage databases and database users by granting the server:create-databases and server:delete-databases permissions.