{{% pageinfo %}} This document is a work in progress. {{% /pageinfo %}}

Tekton provides a component, Tekton Dashboard, as a general-purpose, web-based UI for Tekton Pipelines, which allows developers to:

• View and manage taskRuns and pipelineRuns
• View and manage resources associated with taskRuns and pipelineRuns in their creation, execution, and completion

Try out the tutorial on Katacoda to install the Dashboard in a guided sandbox environment and explore some of its features.

{{% tabs %}}

{{% tab "Kubernetes" %}} To install the latest release of Tekton Dashboard, run the command below:

kubectl apply --filename https://github.com/tektoncd/dashboard/releases/latest/download/tekton-dashboard-release.yaml

{{% /tab %}}

{{% tab "OpenShift" %}} To install the latest release of Tekton Dashboard, run the command below:

kubectl apply --filename https://github.com/tektoncd/dashboard/releases/latest/download/openshift-tekton-dashboard-release.yaml

{{% /tab %}}

{{% /tabs %}}

{{% alert title="Important" color="warning" %}} The latest release may not be compatible with your Tekton Pipelines installation, should you have an earlier release of Tekton Pipelines installed. For more compatibility information, see the Tekton Dashboard's "Which version should I use?" section.

If you would like to install an earlier release of Tekton Dashboard for compatibility reasons, see the note below. {{% /alert %}}

{{% alert title="Note" color="success" %}} To install a different release of Tekton Dashboard, find the .yaml file you would like to use on the Tekton Dashboard Releases page, and run the command below:

# Replace YOUR-RELEASE with the URL of the release you would like to use.
kubectl apply --filename YOUR-RELEASE

{{% /alert %}}

It may take a few moments before the installation completes. You can check the progress with the following command:

kubectl get pods --namespace tekton-pipelines

Confirm that every component listed has the status Running.

Tekton Dashboard is accessible through its cluster IP type service with a reverse proxy. Run the following command:

kubectl proxy --port=8080

And you can open the dashboard in your browser under the address

localhost:8080/api/v1/namespaces/tekton-pipelines/services/tekton-dashboard:http/proxy/

It is also possible to set up port forwarding with Tekton Dashboard:

kubectl --namespace tekton-pipelines port-forward svc/tekton-dashboard 9097:9097

Once set up, the dashboard is available in the browser under the address localhost:9097.

Tekton Dashboard provides many features such as Webhook extension (for setting up a GitHub repository with a Tekton pipeline in the UI), TLS support, and Ingress support. For more information, see the Tekton Dashboard GitHub repository.