Admin Dashboard ScaleEnterpriseSelf-Hosted
The Admin Dashboard provides a web UI to see various details of your Okteto instance in a centralized location and offers features for managing parts of the Okteto experience for your users.
You can access the Admin Dashboard by clicking on the
Admin icon on the left sidebar.
This Admin view consists of the following views currently:
We will cover these in more detail below.
Accessing the dashboard
Only accounts with the administrator role will be able to access the Administration Dashboard. The first user signing up into your Okteto instance will automatically become the initial administrator.
You can promote other accounts to the administrator role in the
Users section of the Admin Dashboard or by adding the
dev.okteto.com/super: "true" label to the corresponding
serviceAccount in Kubernetes.
The overview section of the Admin Dashboard is designed to give you a high level view of your entire Okteto instance. From here, you can drill down into more specific settings and details. This section currently shows you the following information:
- Your current pricing plan
- Okteto Helm chart version
- Okteto CLI version
- Expiration date of your license
- Number of available seats
- Number of nodes in your cluster
- Number of namespaces in your Okteto instance
- Number of preview environments currently active
- Git SSH key
- Autoscaler configuration
- Garbage Collector configuration
With the exception of the
Settings section, this data is informative only. The
Settings section contains a few configurable settings to help you customize your Okteto instance as necessary.
From this section you can manage all users in your Okteto instance. This is a list of all users that have created an account in your Okteto instance, their respective roles, and with appropriate actions to manage their membership.
User column is also the user's default
namespace name/id. For example, a
User value of "darryl" means that that user's namespace will also be called "darryl". Any additional namespaces created by "darryl" will show up only in the
For each user, an administrator will be able to:
- View their name, email, and avatar
- Change their role (
- Remove the user
Removing the user will automatically remove all the namespaces owned by the deleted user.
In this section of the Admin Dashboard, you can find the following system information about your Kubernetes cluster, separated by node:
- Number of running pods
- Number of volumes in use
- Memory utilization
- CPU utilization
You can use this information to configure the autoscaler and optimize your Okteto installation.
This view enables you to manage all of the namespaces within your Okteto instance, including the ability to view (masquerade as the user), wake, or persist any namespace. The top of the namespace table also shows you the default settings for the garbage collection configuration.
For each namespace, an administrator can:
- View the name, owner, status (
Sleeping), and when it was last active
read-onlyaccess to any namespace managed by Okteto (using the
- Manually wake the namespace (using the
- Mark the namespace as
Keep Awakeoption) to exempt it from the garbage collection process
From this page, an administrator can view the default settings for the garbage collection configuration and view any of the listed preview environments.
This table provides a consolidated view about preview environments, including:
- Preview environment name
- Scope (
- Status (
- Last seen
The Secrets section of the Admin dashboard lets you define cluster-wide secrets. Using the
$SECRET_NAME syntax, you can refer to these secrets directly in your Okteto manifest. They are also injected into the environment running the commands in the
deploy section of the manifest.
Secrets defined by the user take precedence over the secrets defined here in case of a name collision.
We recommend using build secrets to inject sensitive data into your Dockerfile.
The example below shows how to configure your okteto manifest to mount a local
.env file into your Dockerfile:
You can refer to this secret from your Dockerfile using the syntax below:
RUN --mount=type=secret,id=my_env,target=/etc/secrets/.env cat /etc/secrets/.env
The content of the
.env file would be:
MY_PASSWORD can be a local environment variable or an Okteto Secret, and it gets subsituted by Okteto before mounting the file as a build secret.
This section of the Admin dashboard enables you to create a catalog of pre-defined development environments for anyone in your Okteto instance to deploy quickly from their
Launch Dev Environment screen. You can reduce the amount of time it takes a developer to get up and running by defining these catalog entries so they're available for developers to select and launch with minimal to no configuration.
This feature is currently available for SaaS single-tenant and Self-Hosted customers only. It is not available in Okteto Cloud (multi-tenant).
In this view you can see the name, repository URL, and edit any pre-existing catalog entries. Please see our Catalog documentation to learn more about how to modify each field.
This makes it simple and fast to edit your catalog entries as your environment changes to manage your applications from this central location.
Okteto is a flexible platform that streamlines your developer operations to make developers faster and more efficient. The initial installation has a few steps and we've built a guided experience to help get you setup even faster than before.
From this page you can follow a simple step-by-step guide to get the major components setup and have your Okteto installation ready to go in minutes. Each of these tasks comes with documentation to help guide you and are also skippable in case they don't apply to you or you simply wish to complete them later.