Skip to main content
Deploy your applications with GitHub Actions using the Qovery CLI.

Prerequisites

Before you can deploy your application with GitHub Actions, you need to:
  1. Install the Qovery CLI
  2. Generate a Qovery API token (via CLI or Console)
  3. Set the environment variable QOVERY_CLI_ACCESS_TOKEN with your API token
  4. Disable Qovery Auto Deployment on the services you want to deploy manually

Deploy a Container Application

Here is an example of a GitHub Actions workflow file (.github/workflows/deploy-with-qovery.yml) to deploy a container application:
This workflow assumes you have:
  • A container registry connected to Qovery
  • An existing container application on Qovery
  • Set the QOVERY_CLI_ACCESS_TOKEN secret in your GitHub repository

Deploy a Single Application

Use the Qovery CLI to deploy a single application:

Deploy Multiple Applications

Different Applications with Different Commits

Multiple Applications with the Same Commit (Monorepo)

Manage Preview Environments

Clone an Environment

Update Application Branch in Cloned Environment

Deploy the Preview Environment

Delete Preview Environment

Integration with Terraform

If you’re using Terraform to manage your infrastructure, you can integrate it with your CI/CD pipeline. See the Terraform Provider documentation for more information.

Next Steps

Qovery CLI

Learn more about Qovery CLI commands

API Token

Generate and manage API tokens

Auto-Deploy

Configure automatic deployments

GitLab CI

Deploy with GitLab CI/CD