Install Devtron OSS

Introduction

Devtron OSS is the open-source edition of Devtron intended for non-enterprise users.

The table below shows the installation options available in Devtron OSS. Further, there are steps given to install your preferred option in your Kubernetes cluster.

Installation Option	What Is Included	When To Use
Minimal (without integrations)	Dashboard + Resource Browser + Core operator configurations	A unified view of Helm apps, FluxCD apps, ArgoCD apps, and their related K8s resources
With CI/CD	Everything in Minimal + Build and Deploy (CI/CD) module	You need a complete CI-CD pipeline for your custom apps (a.k.a Devtron Apps)
With CI/CD + GitOps (Argo CD)	Everything in CI/CD + GitOps (Argo CD) module	You need automated, Git-driven deployments

Not Sure What To Choose?

Begin with the Minimal version. You can always install CI/CD and GitOps integrations later from Devtron Stack Manager.

---

Prerequisites

• Kubernetes cluster v1.16 or later (cloud or local)

• Helm v3.8+ installed

• For production cases, fulfill the Infrastructure Recommendations

Cluster created on AWS? Is your EKS version 1.23 or above?

Install 'AWS EBS CSI' driver using the following command:

helm repo add aws-ebs-csi-driver https://kubernetes-sigs.github.io/aws-ebs-csi-driver
helm repo update
helm upgrade --install aws-ebs-csi-driver \
--namespace kube-system aws-ebs-csi-driver/aws-ebs-csi-driver

Using K3s?

K3s does not include a default storage provisioner, so before you run Helm install in Step 2, apply the Rancher local-path-provisioner to enable dynamic storage:

kubectl apply -f https://raw.githubusercontent.com/rancher/local-path-provisioner/master/deploy/local-path-storage.yaml

Want to Customize the Installation?

See Additional Installation Resources for production infra recommendations, air-gapped installs, blob storage, config overrides, StorageClass, Database, Ingress setup, backups, and more.

---

Step 1: Add Devtron Helm Repository

helm repo add devtron https://helm.devtron.ai
helm repo update devtron

---

Step 2: Choose an Installation Option

Minimal (Dashboard Only)

Install Devtron without Integrations

After you add Devtron Helm Repository run the command below:

helm install devtron devtron/devtron-operator \
--create-namespace --namespace devtroncd

With CI/CD

With CI/CD + GitOps (Argo CD)

How much time does it take for installation?

It usually takes 5–15 minutes to spin up all Devtron microservices (depending on your installation option).

You may check the status by running the command below. If the output is Applied, Devtron is installed.

kubectl -n devtroncd get installers installer-devtron \
-o jsonpath='{.status.sync.status}'

---

Step 3: Obtain the Dashboard URL

For EKS/AKS/GKE

To access the dashboard on EKS, AKS, or GKE cluster, run the following command:

kubectl get svc -n devtroncd devtron-service -o jsonpath='{.status.loadBalancer.ingress}'

Dashboard URL: The LoadBalancer URL displayed in the output

MicroK8s/Kind/K3s (and Cloud VMs)

Minikube

---

Step 4: Log in to Devtron

1. From your browser, visit the dashboard URL (obtained in the previous step) to view the login page of Devtron.

2. Enter admin in the username.

3. Run the below command to get your password.

   kubectl -n devtroncd get secret devtron-secret \
   -o jsonpath='{.data.ADMIN_PASSWORD}' | base64 -d

You should see the Devtron Dashboard post successful login.

Next Recommended Action

After the initial login, we recommend you set up an Single Sign-On (SSO) service like Google, GitHub, etc., and then add other members (including yourself). Thereafter, they can log in using the configured SSO.