--- title: Charmhub | Deploy Juju Dashboard k8s using Charmhub - The Open Operator Collection description: Deploy the latest version of Juju Dashboard k8s as a Kubernetes Operator on any cloud. View the real-time status of your Juju environment. url: https://charmhub.io/juju-dashboard-k8s --- # Juju Dashboard k8s [Juju Engineering](https://charmhub.io/publisher/team-juju "View all packages from Juju Engineering") * [Juju Engineering](https://charmhub.io/publisher/team-juju "View all packages from Juju Engineering") Platform: 0.15/stable 72 ``` juju deploy juju-dashboard-k8s --channel 0.15/stable ``` [Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications) --- #### Relevant links * [Homepage](https://canonical.com/juju) --- #### Contacts * [Submit a bug](https://github.com/canonical/juju-dashboard/issues) --- Share your thoughts on this charm with the community on discourse. [Join the discussion](https://discourse.charmhub.io/) ### [Juju Dashboard for Kubernetes](https://charmhub.io/juju-dashboard-k8s#p-25783-juju-dashboard-for-kubernetes) Juju Dashboard displays your controllers and models, allowing you to see the status of your deployments, manage access, run actions and configure applications. The dashboard can be used with your local Juju environments and can also be found as a part of [JAAS](https://jaas.ai/). #### Deploy Juju Dashboard can be deployed in your controller model using either the [VM charm](https://charmhub.io/juju-dashboard) or [Kubernetes charm](https://charmhub.io/juju-dashboard-k8s) (pre Juju 3.0 controllers included Juju Dashboard automatically). To deploy the dashboard, first switch to the controller model: ``` juju switch controller ``` Next deploy the charm: ``` juju deploy juju-dashboard-k8s dashboard ``` Then integrate the controller and the dashboard: ``` juju integrate dashboard controller ``` Now you can access the dashboard by running: ``` juju dashboard ``` This command will open a connection to the dashboard output the dashboard address and credentials. For further details see the docs on [managing the dashboard](https://juju.is/docs/olm/manage-the-juju-dashboard). #### Deploy with TLS This guide will show the process for deploying Juju Dashboard with a TLS certificate. For demonstration purposes we’ll use self signed certificates. For more information on using certificates in Juju see the [docs](https://charmhub.io/topics/security-with-x-509-certificates). To follow this guide you’ll need a Juju controller bootstrapped in a Microk8s environment. To deploy Juju Dashboard with a TLS certificate we’ll make use of the Kubernetes ingress API. First of all you’ll need to enable the ingress addon: ``` sudo microk8s enable ingress ``` In this scenario the dashboard will need to be deployed in a model that is not the controller model (See [this issue](https://github.com/canonical/nginx-ingress-integrator-operator/issues/3)). However the dashboard requires a relation to the controller, so we need to offer the controller interface so we can make a cross model integration. ``` juju switch controller juju offer controller:dashboard ``` Now create a model for the dashboard: ``` juju add-model juju-dashboard ``` Inside that model deploy nginx-ingress-integrator. This application will provide a bridge between the Kubernetes ingress and Juju Dashboard as well as terminate the TLS certificate. ``` juju deploy nginx-ingress-integrator dashboard-ingress --config service-hostname="dashboard.localhost" service-port=80 juju trust dashboard-ingress --scope cluster ``` Now deploy the self signed certificates charm and integrate it with the ingress app: ``` juju deploy self-signed-certificates --channel 1/stable dashboard-cert juju integrate dashboard-ingress:certificates dashboard-cert:certificates ``` Deploy the dashboard: ``` juju deploy juju-dashboard-k8s dashboard ``` Next, get the name of the controller offer and integrate with the dashboard: ``` juju find-offers # The offer will be something like "admin/controller.controller" juju integrate admin/controller.controller dashboard ``` Integrate the dashboard with the ingress app: ``` juju integrate dashboard dashboard-ingress ``` Check `juju status` and wait for everything to be ready, then you should be able to view the dashboard by visiting: #### Docs Learn more about the Juju Dashboard in the [Juju docs](https://juju.is/docs/olm/the-juju-dashboard). If you’re new to Juju you may also like to take a look at the [getting started](https://juju.is/docs/olm/get-started-with-juju) docs. If you think there’s something that needs documenting or an issue with the current docs let us know either via the [community](https://charmhub.io/juju-dashboard-k8s#community) or [file an issue](https://charmhub.io/juju-dashboard-k8s#issues). #### Community Whether you need help, have suggestions or want to get in contact for any reason you can join us in the [Juju Discourse](https://discourse.charmhub.io/) or find us on [Mattermost](https://chat.charmhub.io/landing#/charmhub/channels/juju). #### Issues If you’ve found a bug then please let us know by filing an issue. If you’re not sure if it’s a bug you can [discuss the issue](https://charmhub.io/juju-dashboard-k8s#community) with us first. Juju Dashboard integrates with a number of parts of the Juju ecosystem. Filing bugs for the relevant codebase will help the issue to be seen by the right team: * Issues with [Juju Dashboard](https://github.com/canonical/juju-dashboard/issues/new/choose). * Issues with the [Dashboard VM or K8s charm](https://github.com/canonical/juju-dashboard-charm/issues/new). * Issues with [Juju](https://bugs.launchpad.net/juju/+filebug) itself or its APIs. * Issues with the [jaas.ai website](https://github.com/canonical/jaas.ai/issues). * Issues with the [juju.is website](https://github.com/canonical/juju.is/issues/new). #### Contributing Juju Dashboard is [open source](https://charmhub.io/juju-dashboard-k8s#licence) and we welcome contributions. Take a look at the [contribution guide](https://github.com/canonical/juju-dashboard/blob/main/docs/CONTRIBUTING.md) guide to find out how to contribute to the project and take a look at the [development guide](https://github.com/canonical/juju-dashboard/blob/main/docs/HACKING.md) to get set up to work on the dashboard. --- [Help improve this document in the forum](https://discourse.charmhub.io/t/juju-dashboard-k8s-docs-index/10773) ([guidelines](https://discourse.charmhub.io/t/how-to-write-docs-our-documentation-guidelines-for-contributors/1245)). Last updated 1 year, 1 month ago.