Aiven MySQL and Koyeb

Aiven for MySQL (opens in a new tab) allows you to get a fully managed MySQL database deployed in the cloud of your choice in a few minutes. Aiven takes care of everything for you including installing security patches, upgrades, automatic backups, and allows you to scale your MySQL databases up or down as needed.

This guide explains how to connect an Aiven managed MySQL database to an application running on Koyeb. To successfully follow this documentation, you will need to have:

The application that connects to the Aiven managed MySQL database uses Prisma as an ORM. Prisma is an open-source ORM. We use it to synchronize our database schema with our Prisma schema.

If you already have a freshly created Aiven managed MySQL database running and want to quickly preview how to connect your database to an application running on Koyeb, use the Deploy to Koyeb button below.

Deploy to Koyeb (opens in a new tab)

Make sure to replace the DATABASE_URL environment variable with the connection string of your Aiven database.

Create an Aiven MySQL database

To create an Aiven managed MySQL database, sign in to your Aiven account (opens in a new tab).

On the Aiven control panel, click the Create Service button to provision a database and access the service creation page.

  1. Select MySQL as the service you want to create.
  2. Choose the Cloud Provider where your Aiven database will run. You can choose between AWS, GCP, Azure, DigitalOcean, and UpCloud. For this guide, we use Google Cloud.
  3. Pick the Region to run the database in. Here, we selected google-europe-west3 (Frankfurt) as our compute will be deployed in this region on Koyeb.
  4. Select the service Plan. Different plans are available depending on what resources and features you need. For this guide, we use the Hobbyist plan.
  5. Give your service a name, e.g. aiven-koyeb.

When you are done configuring your database, click the Create service button. Your database will be provisioned.

Retrieve your Aiven MySQL connection string

From your Aiven MySQL service page, click the Copy button icon on the right side of the Service URI field. The connection string should be similar to the following:


Save it in a safe place, we will need it in the next step to connect our application to the database.

Deploy the application to Koyeb

You can deploy on Koyeb using the control panel or via the Koyeb CLI.

To deploy the example application (opens in a new tab) using the control panel (opens in a new tab), follow these steps:

  1. Click Create Web Service on the Overview tab of the Koyeb control panel.
  2. Select GitHub as the deployment option.
  3. Set as the GitHub repository to deploy.
  4. Expand the Builder section. Click the override toggle associated with the Build command and enter npm run mysql:init in the field.
  5. Expand the Environment variables section. Add a DATABASE_URL environment variable to tell the application how to connect to the Aiven MySQL database. Give the environment variable the name DATABASE_URL and enter the connection string from earlier as the value.
  6. Name your App and Service, for instance express-aiven-mysql.
  7. Click the Deploy button.

A Koyeb App and Service will be created. Your application will be built and deployed to Koyeb. Once the build has finished, you will be able to access your application running on Koyeb by clicking the URL ending with

The example application exposes a /planets endpoint that you can use to list planets from the database. Once your Deployment is live, you should see the following results when navigating to https://<YOUR_APP_URL>

    "id": 1,
    "name": "Mercury"
    "id": 2,
    "name": "Venus"
    "id": 3,
    "name": "Mars"

Delete the example application and Aiven MySQL database

To delete the example application and the Aiven MySQL database and avoid incurring any charges, follow these steps: