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.
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.
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
Installation
Step 1: Install Qovery CLI
Install the Qovery CLI on your local machine:
Linux
MacOS
Windows
Docker
To download and install Qovery CLI on any Linux distribution:curl -s https://get.qovery.com | bash
Qovery is part of AUR packages, so you can install it with yay: Install the Qovery CLI on Linux manually by downloading the latest release, and uncompress its content to a folder into your shell PATH. The common solution to install a command line binary on the MacOS is to use Homebrew.# Add Qovery brew repository
brew tap Qovery/qovery-cli
# Install the CLI
brew install qovery-cli
To download and install Qovery CLI from the command line:curl -s https://get.qovery.com | bash
Install the Qovery CLI on Mac OS manually by downloading the latest release, and uncompress its content to a folder into your shell PATH. The classic way to install binaries on Windows is to use Scoop.# Add Qovery bucket
scoop bucket add qovery https://github.com/Qovery/scoop-qovery-cli
# Install the CLI
scoop install qovery-cli
Install the Qovery CLI on Windows manually by downloading the latest release, and uncompress its content to C:\Windows. Install Docker on your local machine and run the following command:# Pull and Run the latest Qovery CLI
docker run ghcr.io/qovery/qovery-cli:latest help
latest by the version you want to use. For example, to use the version 0.58.4, run:docker run ghcr.io/qovery/qovery-cli:0.58.4 help
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:
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:
The installation typically takes 5-10 minutes.
Post-Installation
After successful deployment:
-
Validate Installation: Check that all Qovery components are running:
kubectl get pods -n qovery
-
Verify in Console: Log in to Qovery Console to confirm your cluster appears with a Connected status.
-
Deploy Applications: You can now start deploying your applications through the Qovery Console.
Next Steps
