Install Devtron Enterprise Trial

Introduction

With the Enterprise version of Devtron, you can access the premium features beyond the open-source version. For your advanced and challenging use cases, you get comprehensive enterprise features including but not limited to:

1. Release orchestration

2. Resource monitoring

3. Advanced filtering

4. Fine-grained access control

5. Security scans

6. Policies related to approval, deployment, plugins, tags, infra...and many more.

In order to use these enhanced features, you can get an uninterrupted 14-day free trial to explore and experience Devtron to its full potential.

---

Install Devtron Enterprise

Please ensure that cluster kubeconfig is properly configured and available in your system.

1. Add Devtron Helm repository

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

1. Depending on your requirements, use any one of the following:

Devtron in Full Mode

To install Devtron with all the features, run the following command:

helm install devtron devtron/devtron-enterprise --create-namespace --namespace devtroncd \
--set devtron.installer.modules={cicd} --set devtron.argo-cd.enabled=true --set devtron.security.enabled=true  \
--set devtron.notifier.enabled=true  --set devtron.security.trivy.enabled=true --set devtron.monitoring.grafana.enabled=true

Devtron without integrations (only Dashboard)

To install Devtron with just the Dashboard and without integrations, run the following command:

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

1. Obtain the Dashboard URL to access Devtron

For EKS/AKS/GKE

Run the following command to get the Dashboard URL:

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

You can access your Devtron Dashboard using the LoadBalancer URL displayed in the output.

MicroK8s/Kind/K3s

Run the following command to port-forward the devtron service to port 8000

kubectl -n devtroncd port-forward service/devtron-service 8000:80

After port-forwarding, you can access the dashboard on this URL: http://127.0.0.1:8000

Minikube

To access the dashboard on Minikube cluster, run the following command:

minikube service devtron-service --namespace devtroncd

This will directly open the dashboard URL on your browser

Cloud VMs

Get devtron-service port number using the following command:

kubectl get svc -n devtroncd devtron-service -o jsonpath='{.spec.ports[0].nodePort}'

The dashboard URL will be: http://<HOST_IP>:<NODEPORT>/dashboard

You will see a License Activation screen upon visiting your Dashboard URL as shown below. If you already have a license key, paste it and click Activate. If not, you can generate a fresh license key.

Figure 1: License Activation Screen

---

Generate License Key

1. You will see an installation fingerprint that uniquely identifies your installation. Copy the fingerprint and click the Get License link.

   

   Figure 2: Copying Installation Fingerprint

What if my installation is airgapped and has no Internet access?

In case your installation is not connected to the Internet, clicking the Get License link will display a QR code that you can scan with an Internet-enabled device to obtain a license (check snapshot).

1. Log in to the License Dashboard using SSO or a valid work email. Personal email addresses are not allowed.

   

   Figure 3: Log in to License Dashboard
2. From your work email address, the system will try to autopopulate the details in the form. If not, you can enter or modify the details too.

   

   Figure 4: Entering User Details
3. Paste the fingerprint you copied earlier and click Get License Key.

   

   Figure 5: Pasting Installation Fingerprint
4. Your license will be generated. Copy the license key.

   

   Figure 6: Copying Generated License Key

Note

The license key you generate will be valid only for your enterprise installation. It is uniquely mapped to your installation fingerprint.

1. Go back to your License Activation page (from step 1). Paste your license key and click Activate.

   

   Figure 7: Pasting License Key and Activating

Facing Issues?

Visit the Troubleshoot section to identify the issue or connect with Devtron Support.

---

Log in to Devtron

1. After successful license activation, you will see the Devtron login page.

   

   Figure 8: Devtron Login Page
2. Initially, log in with the administrator credentials. By default, the username is admin. Run the following command to get the admin password:

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

Note

When you install Devtron for the first time, it creates a default admin user and password (with unrestricted access to Devtron). You can use it to log in as an administrator.

After the initial login, we recommend you set up any Single Sign-On (SSO) service like Google, GitHub, etc., and then add other users (including yourself). Subsequently, all the users can use the same SSO (let's say, GitHub) to log in to the Dashboard.

---

Additional Actions

Check License Details

In Devtron, click the Help menu (top-right corner) → About Devtron to know the following:

• License details (Key and Expiry)

• Installation fingerprint

• Enterprise version

Figure 9: 'About Devtron' Help Menu

Update License

If you have a new license key, you can update the license key directly within Devtron, from the About Devtron page.

Figure 10: Updating License

Renew License

If your trial license has expired and you wish to renew it, email us at [e-mail] or reach out to your Devtron representative.

---

Troubleshoot Issues

Issue	What it means	Where is it shown	Solution
License Claimed Snapshot	Someone from your organization has already availed a license	License Dashboard	Reach out to [e-mail] for another trial
Invalid License Key Snapshot	The license key is incorrect or partial	License Activation Page	Go to the License Dashboard and recheck the license
License Key No Longer Valid Snapshot	The license key has become invalid for your installation fingerprint	License Activation Page	Generate a new license from License Dashboard.
Invalid Fingerprint Snapshot	The fingerprint is incorrect or partial	License Dashboard	Go to the License Activation Page and verify the fingerprint
License Has Expired Snapshot	You have exhausted the free trial	License Activation Page or License Dashboard	Reach out to [e-mail] for renewal
License Key Already Exists for Fingerprint Snapshot	You cannot generate more than 1 license key for 1 fingerprint	License Dashboard	Contact Support