Quickstart

If you are not familiar with Kubernetes, we recommend you to use Qovery on a Managed Kubernetes cluster on AWS, GCP, Scaleway, Azure, or contact us.

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.

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 Qovery managed Kubernetes offer.

Prerequisites

• You have a Kubernetes Kubernetes cluster up and running.
• You have a Kubernetes Kubernetes cluster with at least 4 CPUs and 8GB of RAM.
• You have kubectl installed and configured to access your Kubernetes Kubernetes cluster.
• You have helm installed.
• You have a Qovery account. If you don't have one, please sign up at https://start.qovery.com

Install Qovery on your Kubernetes cluster

Follow this guide to try Qovery on your local machine.

• Automatic
• Manual

1. Install Qovery CLI by running the following command:

   • 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

2. Authenticate with Qovery by running the following command:

   # Sign up and sign in command
   $ qovery auth

   If you are using a headless (without GUI) environment, you can use the following command to sign up and sign in:

   # Sign up and sign in command
   $ qovery auth --headless

   Your browser window with Qovery sign-up page will open. Follow the instructions to sign up and sign in.

3. Install Qovery on your Kubernetes cluster:

   qovery cluster install

   Respond to the prompts to install Qovery on your Kubernetes Kubernetes cluster.

How was it? Did this tutorial work?  Yes  No

That's it, you can now use Qovery on your Kubernetes cluster.

Connect to the Qovery console to validate that Qovery is properly installed and start deploying your applications.

What's Next?

Now that you have Qovery installed on your Kubernetes cluster, you can check that Qovery is properly installed by following the Validate Installation guide.