Skip to main content
Qovery Self-Managed (also known as BYOK: Bring Your Own Kubernetes) is a self-hosted version of Qovery. It allows you to install Qovery on your own Kubernetes cluster.
For Kubernetes Experts Only: Qovery BYOK is for Kubernetes experts who want to manage their own Kubernetes cluster. If you are not familiar with Kubernetes, we recommend using Qovery-Managed Kubernetes on AWS, GCP, Azure, or Scaleway.
Qovery automatically updates ONLY the Qovery applications (agent, shell-agent, etc.) via the Qovery Helm chart. With the self-managed offer, it will be up to you to manage any dependency components (ingress, DNS, logging), making sure they run with the right version over time.The dependencies provided with the Qovery Helm chart are here to help you with the bootstrap, and are not maintained by Qovery. If you want to simplify the maintenance of your cluster, please look at the Qovery managed Kubernetes offer.

​
Prerequisites

Before you begin, ensure you have:
An operational Kubernetes cluster (any distribution)
Minimum 4 CPUs and 8GB RAM available in your cluster
kubectl installed and configured for cluster access
helm package manager installed
Active Qovery account - Sign up here

​
Installation

​
Step 1: Install Qovery CLI

Install the Qovery CLI on your local machine:
  • Linux
  • MacOS
  • Windows
  • Docker
  • *nix
  • Arch Linux
  • Manual
To download and install Qovery CLI on any Linux distribution:
curl -s https://get.qovery.com | bash
Source: CLI installation instructions are maintained in /snippets/install-qovery-cli.mdx. Update snippet first, then copy to all usage locations.

​
Step 2: Authenticate

Authenticate with your Qovery account: 
qovery auth
This will open a browser window for authentication.
For headless environments (CI/CD, remote servers) without a graphical interface, use qovery auth --headless and follow the instructions to authenticate manually.

​
Step 3: Deploy to Kubernetes

Run the installation command and follow the interactive prompts: 
qovery cluster install
The installation typically takes 5-10 minutes.

​
Post-Installation

After successful deployment:
  1. Validate Installation: Check that all Qovery components are running: 
    kubectl get pods -n qovery
  2. Verify in Console: Log in to Qovery Console to confirm your cluster appears with a Connected status.
  3. Deploy Applications: You can now start deploying your applications through the Qovery Console.
For comprehensive validation steps and troubleshooting, see the BYOK Integration Guide.

​
Next Steps

Deploy Your First App

Follow our quickstart guide

BYOK Advanced Configuration

Detailed setup and configuration options
https://mintcdn.com/qovery/bC94RbU5OE288_w9/images/logos/helm-icon.svg?fit=max&auto=format&n=bC94RbU5OE288_w9&q=85&s=e121f3591b805bf648c06ea52783e6ae

Qovery Helm Chart

View on GitHub

Get Help

Contact support