porter/docs/deploy/addons/strapi.md

Deploy Strapi with Porter

This is a quick guide on how to deploy Strapi to a Kubernetes cluster in AWS/GCP/DO using Porter. This guide uses PostgresDB by default - to customize your database settings, modify the files in /app/config/env/production in the example repository.

Quick Deploy

Deploying Strapi

1. Create an account on Porter.
2. One-click provision a Kubernetes cluster in a cloud provider of your choice, or connect an existing cluster.
3. Fork this repository.
4. From the Launch tab, navigate to Web Service > Deploy from Git Repository. Then select the forked repository and Dockerfile in the root directory.
5. Configure the port to 1337, add environment variable NODE_ENV=production, and set resources to the recommended settings (i.e. 2048Mi RAM, 1000 CPU).
6. Hit Deploy!

Deploying PostgresDB

1. Strapi instance deployed through Porter connects to PostgresDB. You can connect Strapi instance deployed on Porter to any external database, but it is also possible to use a database that is also deployed on Porter. Follow this guide to deploy a PostgresDB instance to your cluster in one click.

2. After the database has been deployed, navigate to the Environment variables tab of your deployed Strapi instance. Configure the following environment variables:

   NODE_ENV=production
   DATABASE_HOST=
   DATABASE_PORT=5432
   DATABASE_NAME=
   DATABASE_USERNAME=
   DATABASE_PASSWORD=
   

   To determine what the correct environment variables are in order to connect to the deployed database, see this guide.

Development

To develop, clone the example repository to your local environment and run npm install && npm run develop; from the app directory. Porter will automatically handle CI/CD and propagate your changes to production on every push to the repository.

Questions?

Join the Porter Discord community if you have any questions or need help.