Skip to content

Onboarding wizard#

The onboarding wizard appears the first time you launch Lens Desktop after signing in. It guides you through connecting your Kubernetes clusters and configuring an AI provider for Lens Prism. The wizard has two steps. You can skip either step and complete the setup later.

Tip

To reopen the wizard later, select Help > Welcome from the top menu to open the Welcome Page, then click Open Onboarding Wizard... under Start.

Prerequisites#

Step 1: Connect your clusters#

The first screen presents four connection options as expandable sections. Select the section that matches your environment and provide the required credentials. A green checkmark appears on each section after successful configuration.

AWS (EKS)#

Expand the AWS (EKS) section and choose one of three authentication methods:

  • SSO (recommended): Sign in through your organization's identity provider.
  • Access Key: Enter your AWS Access Key ID and Secret Access Key.
  • IAM Role: Provide the ARN of the IAM role to assume.

Azure (AKS)#

Expand the Azure (AKS) section. Lens Desktop opens a browser-based OAuth flow to authenticate with your Azure account.

MKE#

Expand the MKE section and enter:

  • Cluster URL: The URL of your MKE instance.
  • Username: Your MKE admin username.
  • Password: Your MKE admin password.

Kubeconfig#

Expand the Kubeconfig section and use the file and folder picker to select the kubeconfig files you want to sync.

Tip

You do not need to configure all connection types during the wizard. Add only the environments you need now and configure the rest later.

After connecting your clusters, click Continue. To proceed without connecting any clusters, click Skip.

Step 2: Configure Lens Prism#

On the second screen, select an AI provider for Lens Prism from the Provider Type dropdown and fill in the required fields.

Provider type Required fields
Lens (research preview) No configuration required
Anthropic API Key
OpenAI API Key
Azure API Key, Resource Name, Model IDs
OpenAI-compatible API Key, Base URL, Model IDs

Tip

Generate or retrieve your API key from your provider's console before starting this step:

Optionally, enter a Custom System Prompt to provide additional instructions that shape how Lens Prism responds. The text you enter is appended to every prompt sent to the provider.

Info

All communication happens directly between your machine and your selected provider. Lens does not route or store your prompts. For details, see How to configure AI providers.

Click Finish Setup to complete the wizard. To skip this step, click Skip for now.

Verify the setup#

After the wizard completes, confirm that your configuration is active:

  1. Open the Catalog in the left sidebar. Your connected clusters appear in the cluster list.
  2. Open Lens Prism and send a test prompt to verify the AI provider is working.

Completed

You have successfully configured Lens Desktop. Your clusters appear in the Catalog and Lens Prism is ready to use.

Change settings later#

You can modify both cluster connections and AI provider settings at any time. Navigate to Preferences > Integrations to update your configuration.

Next steps#