How to deploy Strapi with PostgreSQL

This tutorial show you how to deploy Strapi with PostgreSQL in a few steps

This tutorial is linked to this Strapi tutorial

This is a step-by-step guide for deploying a Strapi project on Qovery.

Deploying with the web interface

1. Create a Qovery Account

Visit the Qovery dashboard to create an account if you don't already have one.

2. Create a project

  • Click on the create a project button and give a name to your project.
  • Click on next.

3. Add your Strapi app

  • Click on the create an application button and select your Github or Gitlab repository where your Strapi app is located.
  • Click on next.

4. Add a PostgreSQL database

  • Click on add a PostgreSQL database.
  • Select the version
  • Give a name to your PostgreSQL database.
  • Click on next.

5. Add a storage

  • Click on add a Storage.
  • Give a name to your storage.
  • Select the storage type between Slow HDD, HDD, SSD, and Fast SSD. (SSD is recommended)
  • Select the size.
  • Give a mount point.

6. Deploy

Click on the Deploy button. Your app should be deployed: you can see the status in real time by clicking on Deployment logs.

Deploying with the CLI

1. Create a Qovery Account

Install the Qovery CLI and type the command qovery auth to create an account if you don't already have one.

2. Add a .qovery.yml File

Place a .qovery.yml file at the root of your project. Do not forget the dot when naming the file.

publicly_accessible: true
storage: # qovery will attach automatically a SSD storage on /srv/app
- name: data
type: ssd
size: 5GB
mount_point: /srv/app
- type: postgresql # qovery will create a managed PostgreSQL database
version: 12
name: psql
- name: main
custom_domains: # optional: only if you want to use your domain
- branch: master
domain: my.domain.tld
- application_name: strapi
- /*

Alternatively, you can deploy your Strapi application with a PostgreSQL database in the Qovery dashboard.

3. Add a Dockerfile (optional)

By default, Qovery uses Buildpacks to build and run your Strapi application. But it is also possible to build and run your application by providing a Dockerfile (see Qovery documentation for more information).

4. Deploy

  1. Commit your changes and push them to GitHub or GitLab.
  2. Execute the qovery status --watch command to see in real time your Strapi application deployment status. When the status of your application is RUNNING, it means it has been successfully deployed.


For vertical scaling, Qovery lets you upgrade your CPU and RAM per an instance. For horizontal scaling, Qovery auto-scales the number of instance running depending on the CPU and Memory usage.