Quickstart
Qovery Self-Managed (or BYOK: Bring Your Own Kubernetes) is a self-hosted version of Qovery. It allows you to install Qovery on your own Kubernetes cluster. Read this article to better understand the difference with the Managed Kubernetes by Qovery. In a nutshell, Qovery BYOK is for Kubernetes experts who want to manage their own Kubernetes cluster. In this version, Qovery does not manage the Kubernetes cluster for you.
⚠️ Important considerations
The current state of Qovery BYOK is still in beta. We are working hard to improve it and make it production-ready. Here are some important considerations:
- Contact us if you want to use Qovery BYOK in production. We can assess your setup and validate it's good to go.
- Even if Qovery BYOK is in beta, the Qovery Control Plane and the Qovery Engine are production-ready. BYOK is a lightweight version of our Managed Qovery offer and need time to externalize some configuration parameters mostly. We don't risk to break your cluster, but we prefer be cautious.
- Qovery BYOK is free during the beta period. We will communicate the pricing soon.
- Some features are not available yet. Refer to the table below to see what is available and what is not.
Release date | Feature |
---|---|
✅ Delivered (Dec 2023) | Install Qovery BYOK on your AWS and GCP Kubernetes cluster |
✅ Delivered (Dec 2023) | Deploy your applications |
✅ Delivered (Dec 2023) | Fetch logs |
End of January 2024 | Install Qovery BYOK on any Kubernetes cluster |
Requirements
Have a look at the Requirements section.
Install your cluster
If you already have one you can skip this section.
Install Qovery
Install Helm command line tool.
Add Qovery Helm repository.
helm repo add qovery https://helm.qovery.comhelm repo updateLogin to the Qovery console, create a cluster of type
Self-Managed
. At the end of the flow you will be able to download thevalues.yaml
file associated with this cluster.Now you can customize your values.yaml file based on your need. Learn more about the configuration in the Configuration page.
Learn more about the configuration in the Configuration page.
Install Qovery on your Kubernetes cluster.
helm upgrade --install --wait --atomic --create-namespace -n qovery -f <your-values-file.yaml> \--set services.certificates.cert-manager-configs.enabled=false,services.certificates.qovery-cert-manager-webhook.enabled=false \qovery qovery/qovery-n qovery
: the namespace where Qovery and its dependencies will be installed--set...
: override (only for the first deployment time, if you want to use Cert-Manager) to let cert-manager install its CRDs-f your-values-file.yaml
: the values file you've downloaded, overrided with the Qovery config and your custom configqovery/qovery
: name of the chart to deployqovery
: name of the release
If you want to use Cert-Manager, you can remove the
--set...
for the future updates (or if already installed):helm upgrade --install --create-namespace -n qovery -f <your-values-file.yaml> qovery qovery/qoveryThat's it, you can now use Qovery on your own Kubernetes cluster!