Install Lumovi with its Helm chart, open it, and sign in with a token, in a few minutes.
You need Helm and kubectl on your computer, and an account that can create namespaces, service accounts and role bindings. The cluster needs Kubernetes 1.25 or later, and 1.28 or later to sign in with tokens, as below.
With single sign-on or an authenticating proxy, and for a fleet that includes this cluster, a member or an agent, the chart also makes a ClusterRole that lets Lumovi’s service account impersonate users and groups, and a ClusterRoleBinding that gives it that role. Kubernetes lets you create them only if your account may create cluster roles and their bindings, and may impersonate users and groups itself, or has the escalate and bind verbs on cluster roles. A cluster administrator has all of these. See Impersonation.
This creates a deployment with one Lumovi pod, a lumovi Service on port 80, a service account, and a 2 GiB volume for the audit log, from the cluster’s default storage class. A cluster without a default storage class needs --set audit.persistence.storageClass=<class>, or --set audit.persistence.enabled=false. With the default sign-in (tokens), that service account needs nothing in the cluster: the chart gives it only get and patch on Lumovi’s own Secret and ConfigMap, where it keeps sessions and people’s rules for their assistants.The history on that volume is one Lumovi’s at a time, so the chart runs one pod, and an upgrade stops the old one before it starts the new one. See Where it’s kept.
Then open http://localhost:8080. The chart’s notes, printed after helm install, say the same for your settings.
3
Get a token to sign in with
Any bearer token the cluster accepts works. To try it, make a service account that can view everything, and a token for it:
kubectl create serviceaccount alice --namespace lumovikubectl create clusterrolebinding alice-view --clusterrole view \ --serviceaccount lumovi:alicekubectl create token alice --namespace lumovi
The token is valid for an hour. kubectl create token takes --duration for a longer one, up to what your API server allows.
4
Sign in
Paste the token into Token and choose Sign in. Lumovi asks the cluster whose token it is, and opens the cluster’s overview. You see what the view role allows: most objects, but not Secrets, and nothing you can change.
Signing in with a token.
For people to make changes, bind them a role that allows them, like edit, or admin in their own namespaces. Lumovi asks the cluster what each person may do, and turns off what they can’t, saying why. See Permissions.
Keep your settings in a values file
For anything past a first try, keep the chart’s settings in a file, and install or upgrade from it. Every setting is in Helm values. Artifact Hub has them too, for each version, with the chart’s signature and the image it runs.
# What Lumovi calls the cluster, in its pages and their titles.clusterName: production# The address people open it at.url: https://lumovi.example.comingress: enabled: true className: nginx hosts: [lumovi.example.com] tls: - secretName: lumovi-tls hosts: [lumovi.example.com] annotations: # Pages keep a WebSocket open: don't let the ingress close it after a minute. nginx.ingress.kubernetes.io/proxy-read-timeout: '3600' nginx.ingress.kubernetes.io/proxy-send-timeout: '3600'
The chart’s version is the app’s, so --version 1.23.2 installs Lumovi 1.23.2. Without it, Helm installs the latest.
A fleet, a member or an agent
The same chart installs each part of a fleet, one Lumovi for many clusters. mode says which this release is:
mode
What it installs
For
dashboard (the default)
Lumovi: a Deployment, its Service, a service account, and the ingress, network policy, views and permissions you ask for. With the fleet values, it shows a fleet, and may list Secrets where they say.
The cluster Lumovi runs in
member
A service account that may only impersonate users and groups, and a Secret with a token for it that doesn’t expire. Its notes print the kubeconfig entry to give the fleet’s Lumovi.
Each cluster the fleet’s Lumovi can reach: see Add a cluster
agent
The agent, which dials the fleet’s Lumovi, with a service account that may only impersonate. Its notes print how to list it in Lumovi’s agents.
A member or an agent runs no Lumovi in its cluster, and nobody opens it there. A fleet needs single sign-on or a proxy, so the chart refuses fleet values with auth.mode: token.
Check that it’s running
Lumovi writes a line to its log when it starts, saying which cluster it shows, where, and how people sign in:
kubectl logs --namespace lumovi deployment/lumovi
2026-10-04T10:52:14.120Z Lumovi 1.23.2 shows production (https://10.96.0.1:443) at http://localhost:8080/; people sign in with a token
For a fleet, that line says how many clusters it shows, after a line for each one (Fleet: prod-eu added), like Lumovi 1.23.2 shows a fleet of 3 clusters (hub, prod-eu, staging) at http://localhost:8080/; people sign in with single sign-on.After that, the log records who signs in and out, and what failed. Each audit event is a line of JSON in it too, starting with {"type":"lumovi.audit". A setting that doesn’t make sense stops Lumovi before it starts, and the log says which one and why, like:
LUMOVI_URL must be set for single sign-on: the provider sends people back there.
The chart checks the same things where it can, so helm install fails first with the same advice.
Verify the image
Each release’s image and chart are built, attested and signed by Lumovi’s release workflow on GitHub, from main. Check the attestations with the GitHub CLI:
The same with ghcr.io/lumovi/charts/lumovi:1.23.2 checks the chart. Each passes only for what Lumovi’s release workflow built and signed. What the image is made of, its bills of materials, and how to check them: see Check a release.To pin the image by digest, and have an admission controller require its signature, see Harden it for production.
Next steps
Give it an address
An ingress with TLS, at its own host or below a path.
Choose how people sign in
Tokens, single sign-on, or an authenticating proxy.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Lumovi","description":"A calm, fast Kubernetes dashboard, on your desktop or in your cluster.","colors":{"primary":"#2675d3","light":"#5ea2f0","dark":"#2675d3"},"logo":{"light":"https://mintcdn.com/lumovi/fq-s2pAWvpBwPkck/logo/light.svg?fit=max\u0026auto=format\u0026n=fq-s2pAWvpBwPkck\u0026q=85\u0026s=a8be2c16ee5ce49f5901fdf663f618b6","dark":"https://mintcdn.com/lumovi/fq-s2pAWvpBwPkck/logo/dark.svg?fit=max\u0026auto=format\u0026n=fq-s2pAWvpBwPkck\u0026q=85\u0026s=41e9f674e5f416eeb77eef2a1640fb89","href":"/"},"favicon":"https://mintcdn.com/lumovi/fq-s2pAWvpBwPkck/favicon.svg?fit=max\u0026auto=format\u0026n=fq-s2pAWvpBwPkck\u0026q=85\u0026s=d8a789042372ea44565e0e298ebf6236","appearance":{"default":"system"},"background":{"color":{"light":"#ffffff","dark":"#0a0a0a"}},"navbar":{"links":[{"href":"https://lumovi.dev","label":"Website"},{"href":"https://github.com/Lumovi/Lumovi","type":"github"}],"primary":{"type":"button","label":"Download","href":"https://lumovi.dev/#download"}},"footer":{"socials":{"github":"https://github.com/Lumovi/Lumovi","website":"https://lumovi.dev"},"links":[{"header":"Lumovi","items":[{"label":"Website","href":"https://lumovi.dev"},{"label":"Download","href":"https://lumovi.dev/"},{"label":"Releases","href":"https://github.com/Lumovi/Lumovi/releases"}]},{"header":"Project","items":[{"label":"GitHub","href":"https://github.com/Lumovi/Lumovi"},{"label":"Contributing","href":"https://github.com/Lumovi/Lumovi/blob/main/CONTRIBUTING.md"},{"label":"Security","href":"https://github.com/Lumovi/Lumovi/blob/main/SECURITY.md"},{"label":"Sponsor","href":"https://github.com/sponsors/Lumovi"}]}]},"search":{"prompt":"Search the docs…"},"seo":{"metatags":{"og:site_name":"Lumovi Docs","og:image":"https://docs.lumovi.dev/og.png","og:image:alt":"Lumovi documentation: install Lumovi, connect your clusters, and make the most of every view.","twitter:image:alt":"Lumovi documentation: install Lumovi, connect your clusters, and make the most of every view.","twitter:card":"summary_large_image"}},"fonts":{"family":"Inter"},"icons":{"library":"lucide"},"styling":{"eyebrows":"section","codeblocks":{"theme":{"light":"github-light","dark":"github-dark-default"}},"latex":false},"errors":{"404":{"redirect":false,"title":"Nothing here","description":"This page doesn't exist, or it moved. Try the search, or start from the [introduction](/)."}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"variables":{"version":"1.23.2"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lumovi","hasAudioNarration":false,"actualSubdomain":"lumovi","customDomains":["docs.lumovi.dev"],"gitSource":{"type":"github","owner":"lumovi","repo":"lumovi-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6add9e5d9a241c7512b0456b","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Using Lumovi","count":61},{"language":"default","tag":"In your cluster","count":23},{"language":"default","tag":"Reference","count":19},{"language":"default","tag":"Explore","count":15},{"language":"default","tag":"Make changes","count":8},{"language":"default","tag":"Operate","count":7},{"language":"default","tag":"Debug","count":6},{"language":"default","tag":"AI assistants","count":5},{"language":"default","tag":"Clusters","count":5},{"language":"default","tag":"Get started","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--lumovi-accent: #2675d3;--lumovi-accent-soft: rgb(38 117 211 / 0.1);--lumovi-line: rgb(0 0 0 / 0.08);--lumovi-line-strong: rgb(0 0 0 / 0.14);--lumovi-surface: #ffffff;--lumovi-surface-2: #fafafa;--lumovi-surface-3: #efefef;--lumovi-text-1: #0a0a0a;--lumovi-text-2: #525252;--lumovi-text-3: #6b6b6b;--lumovi-good: #009e00;--lumovi-warn: #bd7800;--lumovi-critical: #d03b3b;--lumovi-neutral: #737373;--lumovi-good-text: #00732b;--lumovi-warn-text: #8a5a00;--lumovi-critical-text: #b42318;--lumovi-neutral-text: #525252;--lumovi-shadow-window: 0 0 0 1px rgb(0 0 0 / 0.06), 0 24px 60px -24px rgb(0 0 0 / 0.28);--lumovi-mono: 'JetBrains Mono', ui-monospace, 'SF Mono', Menlo, Consolas, monospace}:root.dark{--lumovi-accent: #3987e5;--lumovi-accent-soft: rgb(57 135 229 / 0.16);--lumovi-line: rgb(255 255 255 / 0.07);--lumovi-line-strong: rgb(255 255 255 / 0.12);--lumovi-surface: #121212;--lumovi-surface-2: #181818;--lumovi-surface-3: #212121;--lumovi-text-1: #ededed;--lumovi-text-2: #a3a3a3;--lumovi-text-3: #8f8f8f;--lumovi-warn: #fab219;--lumovi-good-text: #3fb950;--lumovi-warn-text: #e3a008;--lumovi-critical-text: #fc554c;--lumovi-neutral-text: #a3a3a3;--lumovi-shadow-window: 0 0 0 1px rgb(255 255 255 / 0.07), 0 40px 100px -30px rgb(0 0 0 / 0.9),\n 0 30px 80px -40px rgb(255 255 255 / 0.08)}code,pre,kbd,.font-mono{font-family:var(--lumovi-mono)!important;font-variant-ligatures:none}@font-face{font-family:'Inter Variable';font-style:normal;font-display:swap;font-weight:100 900;src:url('https://cdn.jsdelivr.net/npm/@fontsource-variable/inter@5.3.0/files/inter-latin-opsz-normal.woff2')\n format('woff2-variations');unicode-range:U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304,\n U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD}#page-title,#content-area :is(h2,h3):not(.not-prose){font-family:'Inter Variable', Inter, sans-serif;font-variation-settings:'opsz' 32;text-wrap:balance}#page-title{letter-spacing:-0.045em}.eyebrow{color:var(--lumovi-text-3)!important}kbd{display:inline-flex;align-items:center;justify-content:center;min-width:1.5em;height:1.5em;padding:0 0.4em;margin:0 0.08em;border-radius:6px;border:1px solid var(--lumovi-line-strong);border-bottom-width:2px;background:var(--lumovi-surface-2);color:var(--lumovi-text-1);font-size:0.78em;font-weight:500;line-height:1;vertical-align:0.08em;white-space:nowrap}.lumovi-shot{margin:1.75rem 0}.lumovi-shot img{width:100%;height:auto;border-radius:12px;box-shadow:var(--lumovi-shadow-window)}.lumovi-hero{position:relative;margin:0.5rem 0 2.5rem;padding:1.25rem;border-radius:20px;background:radial-gradient(70% 80% at 15% 90%, rgb(255 255 255 / 0.9), transparent 70%),\n var(--lumovi-surface-3);border:1px solid var(--lumovi-line)}:root.dark .lumovi-hero{background:radial-gradient(70% 80% at 15% 90%, rgb(255 255 255 / 0.07), transparent 70%),\n var(--lumovi-surface)}.lumovi-hero img{width:100%;height:auto;border-radius:10px;box-shadow:var(--lumovi-shadow-window)}.lumovi-status{display:inline-flex;align-items:center;gap:0.4em;padding:0.1em 0.55em 0.1em 0.45em;border-radius:999px;border:1px solid var(--lumovi-line);background:var(--lumovi-surface-2);font-size:0.85em;font-weight:500;line-height:1.6;white-space:nowrap;color:var(--lumovi-text-1)}.lumovi-status::before{content:'';width:0.55em;height:0.55em;border-radius:999px;background:currentColor;flex:none}.lumovi-status.healthy::before{background:var(--lumovi-good)}.lumovi-status.warning::before{background:var(--lumovi-warn)}.lumovi-status.critical::before{background:var(--lumovi-critical)}.lumovi-status.progressing::before{background:var(--lumovi-neutral);animation:lumovi-pulse 2s ease-in-out infinite}.lumovi-status.neutral::before{background:var(--lumovi-neutral)}@keyframes lumovi-pulse{0%,100%{opacity:1}50%{opacity:0.45}}@media (prefers-reduced-motion: reduce){.lumovi-status.progressing::before{animation:none}}.lumovi-facts{display:grid;grid-template-columns:repeat(auto-fit, minmax(150px, 1fr));gap:1px;margin:1.5rem 0;border-radius:14px;overflow:hidden;border:1px solid var(--lumovi-line);background:var(--lumovi-line)}.lumovi-facts>div{padding:0.9rem 1rem;background:var(--lumovi-surface)}.lumovi-facts dt,.lumovi-facts .lumovi-label{display:block;font-size:0.75rem;font-weight:500;letter-spacing:0.02em;text-transform:uppercase;color:var(--lumovi-text-3)}.lumovi-facts dd,.lumovi-facts .lumovi-value{display:block;margin:0.25rem 0 0;font-size:0.95rem;font-weight:550;color:var(--lumovi-text-1)}"}],"page":{"pagePath":"server/install","slug":"/server/install","pageMetadata":{"title":"Install Lumovi in your cluster","sidebarTitle":"Install","description":"Install Lumovi with its Helm chart, open it, and sign in with a token, in a few minutes.","icon":"download","href":"/server/install"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Install Lumovi with its Helm chart, open it, and sign in with a token, in a few minutes.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,CodeBlock,CodeGroup,Columns,Frame,Heading,Note,OptimizedImage,Step,Steps,Table,Tip}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`You need `,_jsx(_components.a,{href:`https://helm.sh`,children:`Helm`}),` and `,_jsx(_components.code,{children:`kubectl`}),` on your computer, and an account that can create namespaces, service accounts and role bindings. The cluster needs Kubernetes 1.25 or later, and 1.28 or later to sign in with tokens, as below.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`With `,_jsx(_components.a,{href:`/server/auth/single-sign-on`,children:`single sign-on`}),` or an `,_jsx(_components.a,{href:`/server/auth/proxy`,children:`authenticating proxy`}),`, and for a `,_jsx(_components.a,{href:`/server/fleet`,children:`fleet`}),` that includes this cluster, a member or an agent, the chart also makes a ClusterRole that lets Lumovi’s service account impersonate users and groups, and a ClusterRoleBinding that gives it that role. Kubernetes lets you create them only if your account may create cluster roles and their bindings, and may impersonate users and groups itself, or has the `,_jsx(_components.code,{children:`escalate`}),` and `,_jsx(_components.code,{children:`bind`}),` verbs on cluster roles. A cluster administrator has all of these. See `,_jsx(_components.a,{href:`/server/security#impersonation`,children:`Impersonation`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`try-it-in-five-minutes`,children:`Try it in five minutes`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Install the chart`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark-default`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0d1117`,color:`#24292e`,\"--shiki-dark\":`#e6edf3`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFA657`},children:`helm`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` install`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` lumovi`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` oci://ghcr.io/lumovi/charts/lumovi`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FF7B72`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --namespace`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` lumovi`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --create-namespace`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`This creates a deployment with one Lumovi pod, a `,_jsx(_components.code,{children:`lumovi`}),` Service on port 80, a service account, and a 2 GiB volume for the `,_jsx(_components.a,{href:`/server/audit-log`,children:`audit log`}),`, from the cluster’s default storage class. A cluster without a default storage class needs `,_jsx(_components.code,{children:`--set audit.persistence.storageClass=\u003cclass>`}),`, or `,_jsx(_components.code,{children:`--set audit.persistence.enabled=false`}),`. With the default sign-in (tokens), that service account needs nothing in the cluster: the chart gives it only `,_jsx(_components.code,{children:`get`}),` and `,_jsx(_components.code,{children:`patch`}),` on Lumovi’s own Secret and ConfigMap, where it keeps sessions and people’s rules for their assistants.`]}),_jsxs(_components.p,{children:[`The history on that volume is one Lumovi’s at a time, so the chart runs one pod, and an upgrade stops the old one before it starts the new one. See `,_jsx(_components.a,{href:`/server/audit-log#where-it%E2%80%99s-kept`,children:`Where it’s kept`}),`.`]})]}),_jsxs(Step,{title:`Open it`,children:[_jsx(_components.p,{children:`Forward a port from your computer to the Service:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark-default`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0d1117`,color:`#24292e`,\"--shiki-dark\":`#e6edf3`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFA657`},children:`kubectl`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` port-forward`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --namespace`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` lumovi`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` service/lumovi`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` 8080:80`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`Then open `,_jsx(_components.a,{href:`http://localhost:8080`,children:`http://localhost:8080`}),`. The chart’s notes, printed after `,_jsx(_components.code,{children:`helm install`}),`, say the same for your settings.`]})]}),_jsxs(Step,{title:`Get a token to sign in with`,children:[_jsx(_components.p,{children:`Any bearer token the cluster accepts works. To try it, make a service account that can view everything, and a token for it:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark-default`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0d1117`,color:`#24292e`,\"--shiki-dark\":`#e6edf3`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFA657`},children:`kubectl`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` create`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` serviceaccount`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` alice`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --namespace`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` lumovi`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFA657`},children:`kubectl`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` create`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` clusterrolebinding`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` alice-view`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --clusterrole`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` view`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FF7B72`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --serviceaccount`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` lumovi:alice`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFA657`},children:`kubectl`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` create`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` token`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` alice`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --namespace`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` lumovi`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`The token is valid for an hour. `,_jsx(_components.code,{children:`kubectl create token`}),` takes `,_jsx(_components.code,{children:`--duration`}),` for a longer one, up to what your API server allows.`]})]}),_jsxs(Step,{title:`Sign in`,children:[_jsxs(_components.p,{children:[`Paste the token into `,_jsx(_components.strong,{children:`Token`}),` and choose `,_jsx(_components.strong,{children:`Sign in`}),`. Lumovi asks the cluster whose token it is, and opens the cluster’s overview. You see what the `,_jsx(_components.code,{children:`view`}),` role allows: most objects, but not Secrets, and nothing you can change.`]}),_jsxs(Frame,{caption:`Signing in with a token.`,children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,loading:`lazy`,src:`https://cdn.jsdelivr.net/gh/Lumovi/Lumovi@main/docs/screenshots/server-sign-in-light-1x.webp`,alt:`The Lumovi sign-in page, with a field to paste a token, a Sign in button, and the kubectl command that creates a service account's token.`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,loading:`lazy`,src:`https://cdn.jsdelivr.net/gh/Lumovi/Lumovi@main/docs/screenshots/server-sign-in-dark-1x.webp`,alt:`The Lumovi sign-in page, with a field to paste a token, a Sign in button, and the kubectl command that creates a service account's token.`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`For people to make changes, bind them a role that allows them, like `,_jsx(_components.code,{children:`edit`}),`, or `,_jsx(_components.code,{children:`admin`}),` in their own namespaces. Lumovi asks the cluster what each person may do, and turns off what they can’t, saying why. See `,_jsx(_components.a,{href:`/clusters/permissions`,children:`Permissions`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`keep-your-settings-in-a-values-file`,children:`Keep your settings in a values file`}),`\n`,_jsxs(_components.p,{children:[`For anything past a first try, keep the chart’s settings in a file, and install or upgrade from it. Every setting is in `,_jsx(_components.a,{href:`/server/helm-values`,children:`Helm values`}),`. `,_jsx(_components.a,{href:`https://artifacthub.io/packages/helm/lumovi/lumovi`,children:`Artifact Hub`}),` has them too, for each version, with the chart’s signature and the image it runs.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`values.yaml`,numberOfLines:`17`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark-default`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0d1117`,color:`#24292e`,\"--shiki-dark\":`#e6edf3`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`17`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#8B949E`},children:`# What Lumovi calls the cluster, in its pages and their titles.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#22863A`,\"--shiki-dark\":`#7EE787`},children:`clusterName`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:`production`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#8B949E`},children:`# The address people open it at.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#22863A`,\"--shiki-dark\":`#7EE787`},children:`url`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:`https://lumovi.example.com`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#22863A`,\"--shiki-dark\":`#7EE787`},children:`ingress`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#22863A`,\"--shiki-dark\":`#7EE787`},children:` enabled`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:`true`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#22863A`,\"--shiki-dark\":`#7EE787`},children:` className`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:`nginx`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#22863A`,\"--shiki-dark\":`#7EE787`},children:` hosts`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`: [`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:`lumovi.example.com`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`]`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#22863A`,\"--shiki-dark\":`#7EE787`},children:` tls`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:` - `}),_jsx(_components.span,{style:{color:`#22863A`,\"--shiki-dark\":`#7EE787`},children:`secretName`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:`lumovi-tls`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#22863A`,\"--shiki-dark\":`#7EE787`},children:` hosts`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`: [`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:`lumovi.example.com`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`]`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#22863A`,\"--shiki-dark\":`#7EE787`},children:` annotations`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`:`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A737D`,\"--shiki-dark\":`#8B949E`},children:` # Pages keep a WebSocket open: don't let the ingress close it after a minute.`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#22863A`,\"--shiki-dark\":`#7EE787`},children:` nginx.ingress.kubernetes.io/proxy-read-timeout`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:`'3600'`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#22863A`,\"--shiki-dark\":`#7EE787`},children:` nginx.ingress.kubernetes.io/proxy-send-timeout`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:`'3600'`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Install or upgrade`,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark-default`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0d1117`,color:`#24292e`,\"--shiki-dark\":`#e6edf3`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFA657`},children:`helm`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` upgrade`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --install`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` lumovi`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` oci://ghcr.io/lumovi/charts/lumovi`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FF7B72`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --namespace`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` lumovi`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --create-namespace`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FF7B72`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --values`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` values.yaml`})]}),`\n`]})})})]}),`\n`,_jsxs(_components.p,{children:[`The chart’s version is the app’s, so `,_jsx(_components.code,{children:`--version 1.23.2`}),` installs Lumovi 1.23.2. Without it, Helm installs the latest.`]}),`\n`,_jsx(Heading,{level:`2`,id:`a-fleet-a-member-or-an-agent`,children:`A fleet, a member or an agent`}),`\n`,_jsxs(_components.p,{children:[`The same chart installs each part of a `,_jsx(_components.a,{href:`/server/fleet`,children:`fleet`}),`, one Lumovi for many clusters. `,_jsx(_components.code,{children:`mode`}),` says which this release is:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`mode`})}),_jsx(_components.th,{children:`What it installs`}),_jsx(_components.th,{children:`For`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`dashboard`}),` (the default)`]}),_jsxs(_components.td,{children:[`Lumovi: a Deployment, its Service, a service account, and the ingress, network policy, views and permissions you ask for. With the `,_jsxs(_components.a,{href:`/server/helm-values#a-fleet`,children:[_jsx(_components.code,{children:`fleet`}),` values`]}),`, it shows a fleet, and may list Secrets where they say.`]}),_jsx(_components.td,{children:`The cluster Lumovi runs in`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`member`})}),_jsx(_components.td,{children:`A service account that may only impersonate users and groups, and a Secret with a token for it that doesn’t expire. Its notes print the kubeconfig entry to give the fleet’s Lumovi.`}),_jsxs(_components.td,{children:[`Each cluster the fleet’s Lumovi can reach: see `,_jsx(_components.a,{href:`/server/fleet/members`,children:`Add a cluster`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent`})}),_jsx(_components.td,{children:`The agent, which dials the fleet’s Lumovi, with a service account that may only impersonate. Its notes print how to list it in Lumovi’s agents.`}),_jsxs(_components.td,{children:[`Each cluster it can’t reach: see `,_jsx(_components.a,{href:`/server/fleet/agents`,children:`Private clusters`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`A member or an agent runs no Lumovi in its cluster, and nobody opens it there. A fleet needs single sign-on or a proxy, so the chart refuses `,_jsx(_components.code,{children:`fleet`}),` values with `,_jsx(_components.code,{children:`auth.mode: token`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`check-that-it’s-running`,children:`Check that it’s running`}),`\n`,_jsx(_components.p,{children:`Lumovi writes a line to its log when it starts, saying which cluster it shows, where, and how people sign in:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark-default`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0d1117`,color:`#24292e`,\"--shiki-dark\":`#e6edf3`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFA657`},children:`kubectl`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` logs`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --namespace`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` lumovi`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` deployment/lumovi`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark-default`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0d1117`,color:`#24292e`,\"--shiki-dark\":`#e6edf3`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`2026-10-04T10:52:14.120Z Lumovi 1.23.2 shows production (https://10.96.0.1:443) at http://localhost:8080/; people sign in with a token`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`For a fleet, that line says how many clusters it shows, after a line for each one (`,_jsx(_components.code,{children:`Fleet: prod-eu added`}),`), like `,_jsx(_components.code,{children:`Lumovi 1.23.2 shows a fleet of 3 clusters (hub, prod-eu, staging) at http://localhost:8080/; people sign in with single sign-on`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`After that, the log records who signs in and out, and what failed. Each `,_jsx(_components.a,{href:`/server/audit-log#on-the-server%E2%80%99s-output`,children:`audit event`}),` is a line of JSON in it too, starting with `,_jsx(_components.code,{children:`{\"type\":\"lumovi.audit\"`}),`. A setting that doesn’t make sense stops Lumovi before it starts, and the log says which one and why, like:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark-default`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0d1117`,color:`#24292e`,\"--shiki-dark\":`#e6edf3`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`LUMOVI_URL must be set for single sign-on: the provider sends people back there.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`The chart checks the same things where it can, so `,_jsx(_components.code,{children:`helm install`}),` fails first with the same advice.`]}),`\n`,_jsx(Heading,{level:`2`,id:`verify-the-image`,children:`Verify the image`}),`\n`,_jsxs(_components.p,{children:[`Each release’s image and chart are built, attested and signed by Lumovi’s release workflow on GitHub, from `,_jsx(_components.code,{children:`main`}),`. Check the attestations with the `,_jsx(_components.a,{href:`https://cli.github.com`,children:`GitHub CLI`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark-default`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0d1117`,color:`#24292e`,\"--shiki-dark\":`#e6edf3`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`signer`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#FF7B72`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`(`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:`--repo`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` Lumovi/Lumovi`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` --signer-workflow`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` Lumovi/Lumovi/.github/workflows/release.yml`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` --source-ref`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` refs/heads/main`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFA657`},children:`gh`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` attestation`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` verify`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` oci://ghcr.io/lumovi/lumovi:1.23.2`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:' \"${'}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`signer`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:`[`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#FF7B72`},children:`@`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:`]}\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFA657`},children:`gh`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` attestation`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` verify`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` oci://ghcr.io/lumovi/charts/lumovi:1.23.2`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:' \"${'}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E6EDF3`},children:`signer`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:`[`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#FF7B72`},children:`@`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:`]}\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`And the signatures with `,_jsx(_components.a,{href:`https://docs.sigstore.dev/cosign/system_config/installation/`,children:`cosign`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark-default`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#0d1117`,color:`#24292e`,\"--shiki-dark\":`#e6edf3`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#FFA657`},children:`cosign`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` verify`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` ghcr.io/lumovi/lumovi:1.23.2`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FF7B72`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --certificate-identity`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` https://github.com/Lumovi/Lumovi/.github/workflows/release.yml@refs/heads/main`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#FF7B72`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79C0FF`},children:` --certificate-oidc-issuer`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#A5D6FF`},children:` https://token.actions.githubusercontent.com`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The same with `,_jsx(_components.code,{children:`ghcr.io/lumovi/charts/lumovi:1.23.2`}),` checks the chart. Each passes only for what Lumovi’s release workflow built and signed. What the image is made of, its bills of materials, and how to check them: see `,_jsx(_components.a,{href:`/server/security#check-a-release`,children:`Check a release`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`To pin the image by digest, and have an admission controller require its signature, see `,_jsx(_components.a,{href:`/server/hardening#the-image`,children:`Harden it for production`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Give it an address`,icon:`globe`,href:`/server/expose`,children:_jsx(_components.p,{children:`An ingress with TLS, at its own host or below a path.`})}),_jsx(Card,{title:`Choose how people sign in`,icon:`log-in`,href:`/server/auth/single-sign-on`,children:_jsx(_components.p,{children:`Tokens, single sign-on, or an authenticating proxy.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark-default"}},"config":{},"pageMetadata":{"title":"Install Lumovi in your cluster","sidebarTitle":"Install","description":"Install Lumovi with its Helm chart, open it, and sign in with a token, in a few minutes.","icon":"download","href":"/server/install"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Try it in five minutes","slug":"try-it-in-five-minutes","depth":2,"children":[]},{"title":"Keep your settings in a values file","slug":"keep-your-settings-in-a-values-file","depth":2,"children":[]},{"title":"A fleet, a member or an agent","slug":"a-fleet-a-member-or-an-agent","depth":2,"children":[]},{"title":"Check that it’s running","slug":"check-that-it’s-running","depth":2,"children":[]},{"title":"Verify the image","slug":"verify-the-image","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/lumovi/c0a393983dcc12d8/screenshots.js"],"dynamicCss":".mint-block {\n display: block\n}\n.mint-hidden {\n display: none\n}\n.dark\\:mint-block:is(.dark *) {\n display: block\n}\n.dark\\:mint-hidden:is(.dark *) {\n display: none\n}","subdomain":"lumovi","siteName":"Lumovi","title":"Install Lumovi in your cluster - Lumovi","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-25T06:15:02.894Z","originalFileLocation":"server/install.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Install Lumovi with its Helm chart, open it, and sign in with a token, in a few minutes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Lumovi\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lumovi/fgE7c32ETUSKvpxm/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/lumovi/fgE7c32ETUSKvpxm/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lumovi/fgE7c32ETUSKvpxm/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lumovi/fgE7c32ETUSKvpxm/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lumovi/fgE7c32ETUSKvpxm/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lumovi/fgE7c32ETUSKvpxm/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lumovi/fgE7c32ETUSKvpxm/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lumovi/fgE7c32ETUSKvpxm/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lumovi/fgE7c32ETUSKvpxm/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Install Lumovi in your cluster - Lumovi\">\u003cmeta data-mint-head property=\"og:description\" content=\"Install Lumovi with its Helm chart, open it, and sign in with a token, in a few minutes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Lumovi Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.lumovi.dev/server/install\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.lumovi.dev/og.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Install Lumovi in your cluster - Lumovi\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Install Lumovi with its Helm chart, open it, and sign in with a token, in a few minutes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.lumovi.dev/og.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/lumovi/fgE7c32ETUSKvpxm/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Lumovi\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2675d3\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"Lumovi documentation: install Lumovi, connect your clusters, and make the most of every view.\">\u003cmeta data-mint-head name=\"twitter:image:alt\" content=\"Lumovi documentation: install Lumovi, connect your clusters, and make the most of every view.\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.lumovi.dev/server/install\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/server/install.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.lumovi.dev/#organization\",\"name\":\"Lumovi\",\"url\":\"https://docs.lumovi.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/lumovi/fq-s2pAWvpBwPkck/logo/light.svg?fit=max\u0026auto=format\u0026n=fq-s2pAWvpBwPkck\u0026q=85\u0026s=a8be2c16ee5ce49f5901fdf663f618b6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.lumovi.dev#website\",\"name\":\"Lumovi\",\"url\":\"https://docs.lumovi.dev\",\"publisher\":{\"@id\":\"https://docs.lumovi.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.lumovi.dev/server/install#webpage\",\"url\":\"https://docs.lumovi.dev/server/install\",\"name\":\"Install Lumovi in your cluster\",\"description\":\"Install Lumovi with its Helm chart, open it, and sign in with a token, in a few minutes.\",\"dateModified\":\"2026-10-25T06:15:02.894Z\",\"isPartOf\":{\"@id\":\"https://docs.lumovi.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.lumovi.dev/server/install#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.lumovi.dev/server/install#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Run it in your cluster\",\"item\":\"https://docs.lumovi.dev/server/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Install Lumovi in your cluster\",\"item\":\"https://docs.lumovi.dev/server/install\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.lumovi.dev/server/install#article\",\"headline\":\"Install Lumovi in your cluster\",\"name\":\"Install Lumovi in your cluster\",\"description\":\"Install Lumovi with its Helm chart, open it, and sign in with a token, in a few minutes.\",\"url\":\"https://docs.lumovi.dev/server/install\",\"mainEntityOfPage\":{\"@id\":\"https://docs.lumovi.dev/server/install#webpage\"},\"image\":\"https://docs.lumovi.dev/og.png\",\"dateModified\":\"2026-10-25T06:15:02.894Z\",\"publisher\":{\"@id\":\"https://docs.lumovi.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.lumovi.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Lumovi\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Lumovi\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/server/install.md","siteName":"Lumovi","nav":{"global":null,"tabs":[{"tab":"Using Lumovi","icon":"book-open","pages":[{"title":"Using Lumovi","href":""}]},{"tab":"In your cluster","icon":"server","groups":[{"group":"Run it in your cluster","pages":[{"title":"Lumovi in your cluster","sidebarTitle":"Overview","description":"Serve Lumovi from your cluster as a web dashboard: your team opens a link, signs in, and sees and changes what their own RBAC allows.","icon":"server","href":"/server/overview"},{"title":"Install Lumovi in your cluster","sidebarTitle":"Install","icon":"download","href":"/server/install"},{"title":"Give Lumovi an address","sidebarTitle":"Address and ingress","description":"Put Lumovi behind an ingress with TLS, at a host of its own or below a path, and keep its WebSocket open.","icon":"globe","href":"/server/expose"},{"title":"Lumovi on a phone","sidebarTitle":"On a phone","icon":"smartphone","href":"/server/phone"},{"title":"Upgrade Lumovi in your cluster","sidebarTitle":"Upgrade","icon":"circle-arrow-up","href":"/server/upgrade"}]},{"group":"Sign-in","pages":[{"title":"Sign in with a token","sidebarTitle":"Tokens","icon":"key-round","href":"/server/auth/tokens"},{"title":"Sign in with single sign-on","sidebarTitle":"Single sign-on","icon":"log-in","href":"/server/auth/single-sign-on"},{"title":"Sign in through an authenticating proxy","sidebarTitle":"Authenticating proxy","icon":"route","href":"/server/auth/proxy"},{"title":"Access for your team","sidebarTitle":"Access","icon":"shield","href":"/server/access"}]},{"group":"Fleet","pages":[{"title":"A fleet of clusters","sidebarTitle":"Fleet","icon":"boxes","href":"/server/fleet"},{"title":"Add a cluster to a fleet","sidebarTitle":"Add a cluster","icon":"circle-plus","href":"/server/fleet/members"},{"title":"Clusters from Secrets","sidebarTitle":"Clusters from Secrets","icon":"key-round","href":"/server/fleet/discovery"},{"title":"Private clusters","sidebarTitle":"Private clusters","icon":"radio-tower","href":"/server/fleet/agents"},{"title":"Run a fleet on Sevalla","sidebarTitle":"On Sevalla","icon":"cloud","href":"/server/fleet/sevalla"}]},{"group":"Operate","pages":[{"title":"Security in your cluster","sidebarTitle":"Security","icon":"shield-check","href":"/server/security"},{"title":"Harden it for production","sidebarTitle":"Hardening","icon":"shield-plus","href":"/server/hardening"},{"title":"Proxies and certificate authorities","sidebarTitle":"Proxy and certificates","icon":"globe-lock","href":"/server/network"},{"title":"Plugins for everyone","sidebarTitle":"Shared plugins","icon":"layout-template","href":"/server/plugins"},{"title":"AI assistants for your team","sidebarTitle":"AI assistants","icon":"users","href":"/server/assistants"},{"title":"Audit log for your team","sidebarTitle":"Audit log","icon":"scroll-text","href":"/server/audit-log"},{"title":"Run it without Kubernetes","sidebarTitle":"With Docker","icon":"container","href":"/server/docker"}]},{"group":"Reference","pages":[{"title":"Helm values","icon":"sliders-horizontal","href":"/server/helm-values"},{"title":"Server configuration","sidebarTitle":"Configuration","icon":"settings-2","href":"/server/configuration"}]}]},{"tab":"Reference","icon":"library","pages":[{"title":"Reference","href":"/reference/keyboard-shortcuts"}]}]},"basePath":"","title":"Install Lumovi in your cluster - Lumovi","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DBAS9Liu.js","DynamicMarkdown-C4w9kavL.js","zoom-image-lightbox-B9O1U98p.js","lightbox-handle-r17bVUz3.js"]}