Run the open-source engine on your own hardware. One command brings up the stack and wires your agents to it.
The Klio engine is open source and self-hostable. Self-hosting is free, nothing
leaves your machine, and the custody guarantees are stronger than Cloud’s:
memory is encrypted at rest under a key you own, and every write is chained
with SHA-256 so the history is tamper-evident.What you get is the core memory engine — capture, recall, spaces, projects
and the curator. The layers built on top of the store are Cloud-only: the
knowledge graph that links memories to the entities they are about, hybrid
recall that matches exact identifiers as well as meaning, artifacts,
compression, and the reconciliation pass that judges when a new fact
contradicts an older one and retires it.So the trade is custody against capability. If memory must not leave your
network, self-host. If you want everything that reasons over the store, use
Cloud — all of it is on the Free plan, so you can compare them without paying.
Prerequisites
Docker running — check with docker info
Node 20+ — needed only to run the launcher via npx
~8 GB free disk for the container images
(macOS, if you choose the Ollama provider) a working ollama install for
Metal acceleration. On Linux the docker-ollama compose profile is used as a
CPU fallback.
Install
npx @klio-tech/klio init
That single command pulls the containers (engine, bridge, dashboard, plus
Postgres and Redis), boots them, runs migrations, walks you through provider and
model selection, detects every supported AI agent on your machine, and patches
each one’s MCP config.Roughly 30 seconds on a warm Docker, about two minutes on a cold first run.
klio init accepts --local or --cloud to skip the prompt, and --email <addr> to pre-fill the claim address. Pin a specific build with
--image-tag <tag>.
Confirm it is up
npx @klio-tech/klio status
This reports what is running, where, and as whom. Your agents should now list
the ten Klio tools without any further configuration — the launcher already
wrote their MCP config for you.
What you get that Cloud does not
Keys you own
Memory is encrypted at rest under a key you hold. On Klio Cloud the keys are
ours.
Tamper-evident history
Every write is chained with SHA-256, so the history can be independently
verified. Cloud writes are not hash-chained today.
Anywhere the docs mention a user-held encryption key or a hash chain, that
refers to the self-hosted engine specifically. See
What Klio keeps for the
Cloud equivalent.
Connecting agents manually
The launcher patches agent configs for you, but if you need to wire one by hand
it is the same MCP endpoint on your own host:
http://localhost:8080/mcp
Everything in Any MCP client applies unchanged —
only the base URL differs.
uninstall deletes your memory store. down is the one you want for stopping
the stack temporarily.
Source and licence
The engine lives at
github.com/klio-tech/klio. Klio is open
core, and the line is capability rather than hosting: the memory engine and MCP
shim are open source and free to run yourself, while the graph, hybrid recall,
artifacts, compression and reconciliation are part of Klio Cloud. Cloud is not
the same software with a bill attached.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Klio","description":"Klio is a shared workplace for AI agents. Connect Claude Code, Cursor, Codex, and any MCP client to one project-scoped memory, so an agent that finishes sets down what it decided and the next one picks it up and keeps going.","colors":{"primary":"#B0421A","light":"#D4623A","dark":"#8E3413"},"logo":{"light":"https://mintcdn.com/klio/ePftTmJOPX2G0TAF/logo/light.svg?fit=max\u0026auto=format\u0026n=ePftTmJOPX2G0TAF\u0026q=85\u0026s=e37298d4e5f0c0cec586c9cb935a5448","dark":"https://mintcdn.com/klio/ePftTmJOPX2G0TAF/logo/dark.svg?fit=max\u0026auto=format\u0026n=ePftTmJOPX2G0TAF\u0026q=85\u0026s=81613d458a3fbdf99564d6e4a569fb08"},"favicon":"https://mintcdn.com/klio/ePftTmJOPX2G0TAF/favicon.svg?fit=max\u0026auto=format\u0026n=ePftTmJOPX2G0TAF\u0026q=85\u0026s=49a45d2f2acfc2e49ec1211dd9462926","navbar":{"links":[{"href":"mailto:contact@klio.tech","label":"Support"}],"primary":{"type":"button","label":"Start free","href":"https://app.klio.tech/auth/sign-up"}},"footer":{"socials":{"x":"https://x.com/klio_tech","github":"https://github.com/klio-tech"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/klio-tech/klio"},{"anchor":"Dashboard","icon":"gauge","href":"https://app.klio.tech"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"klio","hasAudioNarration":false,"actualSubdomain":"klio","customDomains":["docs.klio.tech"],"gitSource":{"type":"github","owner":"klio-tech","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aea21030ce963de28ad691f:success","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Tool reference","count":12},{"language":"default","tag":"Documentation","count":11},{"language":"default","tag":"Writing","count":5},{"language":"default","tag":"Concepts","count":4},{"language":"default","tag":"Connect an agent","count":3},{"language":"default","tag":"Get started","count":2},{"language":"default","tag":"Self-hosting","count":2},{"language":"default","tag":"Artifacts","count":2},{"language":"default","tag":"Overview","count":2},{"language":"default","tag":"Managing","count":2}]},"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":"site-roles","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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":[]}
{"page":{"pagePath":"self-host/install","slug":"/self-host/install","pageMetadata":{"title":"Self-hosting Klio","description":"Run the open-source engine on your own hardware. One command brings up the stack and wires your agents to it.","href":"/self-host/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: \"Run the open-source engine on your own hardware. One command brings up the stack and wires your agents to it.\"\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`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CodeBlock,Columns,Heading,Info,Table,Tip,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The Klio engine is open source and self-hostable. Self-hosting is free, nothing\nleaves your machine, and the custody guarantees are stronger than Cloud’s:\nmemory is encrypted at rest under a key `,_jsx(_components.strong,{children:`you`}),` own, and every write is chained\nwith SHA-256 so the history is tamper-evident.`]}),`\n`,_jsxs(_components.p,{children:[`What you get is the `,_jsx(_components.strong,{children:`core memory engine`}),` — capture, recall, spaces, projects\nand the curator. The layers built on top of the store are Cloud-only: the\nknowledge graph that links memories to the entities they are about, hybrid\nrecall that matches exact identifiers as well as meaning, artifacts,\ncompression, and the reconciliation pass that judges when a new fact\ncontradicts an older one and retires it.`]}),`\n`,_jsx(_components.p,{children:`So the trade is custody against capability. If memory must not leave your\nnetwork, self-host. If you want everything that reasons over the store, use\nCloud — all of it is on the Free plan, so you can compare them without paying.`}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Docker`}),` running — check with `,_jsx(_components.code,{children:`docker info`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Node 20+`}),` — needed only to run the launcher via `,_jsx(_components.code,{children:`npx`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`~8 GB free disk`}),` for the container images`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.em,{children:`(macOS, if you choose the Ollama provider)`}),` a working `,_jsx(_components.code,{children:`ollama`}),` install for\nMetal acceleration. On Linux the `,_jsx(_components.code,{children:`docker-ollama`}),` compose profile is used as a\nCPU fallback.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`install`,children:`Install`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @klio-tech/klio`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` init`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`That single command pulls the containers (engine, bridge, dashboard, plus\nPostgres and Redis), boots them, runs migrations, walks you through provider and\nmodel selection, detects every supported AI agent on your machine, and patches\neach one’s MCP config.`}),`\n`,_jsx(_components.p,{children:`Roughly 30 seconds on a warm Docker, about two minutes on a cold first run.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`klio init`}),` accepts `,_jsx(_components.code,{children:`--local`}),` or `,_jsx(_components.code,{children:`--cloud`}),` to skip the prompt, and `,_jsx(_components.code,{children:`--email \u003caddr>`}),` to pre-fill the claim address. Pin a specific build with\n`,_jsx(_components.code,{children:`--image-tag \u003ctag>`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`confirm-it-is-up`,children:`Confirm it is up`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @klio-tech/klio`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` status`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`This reports what is running, where, and as whom. Your agents should now list\nthe ten Klio tools without any further configuration — the launcher already\nwrote their MCP config for you.`}),`\n`,_jsx(Heading,{level:`2`,id:`what-you-get-that-cloud-does-not`,children:`What you get that Cloud does not`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Keys you own`,icon:`key`,children:_jsx(_components.p,{children:`Memory is encrypted at rest under a key you hold. On Klio Cloud the keys are\nours.`})}),_jsx(Card,{title:`Tamper-evident history`,icon:`link`,children:_jsx(_components.p,{children:`Every write is chained with SHA-256, so the history can be independently\nverified. Cloud writes are not hash-chained today.`})})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Anywhere the docs mention a user-held encryption key or a hash chain, that\nrefers to the `,_jsx(_components.strong,{children:`self-hosted`}),` engine specifically. See\n`,_jsx(_components.a,{href:`/concepts/what-klio-keeps#where-it-physically-lives`,children:`What Klio keeps`}),` for the\nCloud equivalent.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`connecting-agents-manually`,children:`Connecting agents manually`}),`\n`,_jsx(_components.p,{children:`The launcher patches agent configs for you, but if you need to wire one by hand\nit is the same MCP endpoint on your own host:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`http://localhost:8080/mcp`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Everything in `,_jsx(_components.a,{href:`/connect/any-mcp-client`,children:`Any MCP client`}),` applies unchanged —\nonly the base URL differs.`]}),`\n`,_jsx(Heading,{level:`2`,id:`day-two-operations`,children:`Day-two operations`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Command`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`npx @klio-tech/klio status`})}),_jsx(_components.td,{children:`Show what is running, where, and as whom`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`npx @klio-tech/klio update`})}),_jsx(_components.td,{children:`Re-prompt provider/model, or upgrade the stack`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`npx @klio-tech/klio configure`})}),_jsx(_components.td,{children:`Tweak runtime settings (auto-update mode, claim email)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`npx @klio-tech/klio down`})}),_jsxs(_components.td,{children:[`Stop the stack — `,_jsx(_components.strong,{children:`data is preserved`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`npx @klio-tech/klio uninstall`})}),_jsxs(_components.td,{children:[`Stop and `,_jsx(_components.strong,{children:`delete all data`}),`; restore agent configs from backup`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/self-host/cli`,children:`CLI reference`}),` for the full flag set.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`uninstall`}),` deletes your memory store. `,_jsx(_components.code,{children:`down`}),` is the one you want for stopping\nthe stack temporarily.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`source-and-licence`,children:`Source and licence`}),`\n`,_jsxs(_components.p,{children:[`The engine lives at\n`,_jsx(_components.a,{href:`https://github.com/klio-tech/klio`,children:`github.com/klio-tech/klio`}),`. Klio is open\ncore, and the line is capability rather than hosting: the memory engine and MCP\nshim are open source and free to run yourself, while the graph, hybrid recall,\nartifacts, compression and reconciliation are part of Klio Cloud. Cloud is not\nthe same software with a bill attached.`]})]})}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":{"config":{},"pageMetadata":{"title":"Self-hosting Klio","description":"Run the open-source engine on your own hardware. One command brings up the stack and wires your agents to it.","href":"/self-host/install"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Install","slug":"install","depth":2,"children":[]},{"title":"Confirm it is up","slug":"confirm-it-is-up","depth":2,"children":[]},{"title":"What you get that Cloud does not","slug":"what-you-get-that-cloud-does-not","depth":2,"children":[]},{"title":"Connecting agents manually","slug":"connecting-agents-manually","depth":2,"children":[]},{"title":"Day-two operations","slug":"day-two-operations","depth":2,"children":[]},{"title":"Source and licence","slug":"source-and-licence","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"klio","siteName":"Klio","title":"Self-hosting Klio - Klio","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-11T14:40:16.836Z","originalFileLocation":"self-host/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=\"Run the open-source engine on your own hardware. One command brings up the stack and wires your agents to it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Klio\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/klio/sXLZyfL6a6imnlgG/_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/klio/sXLZyfL6a6imnlgG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/klio/sXLZyfL6a6imnlgG/_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/klio/sXLZyfL6a6imnlgG/_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/klio/sXLZyfL6a6imnlgG/_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/klio/sXLZyfL6a6imnlgG/_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/klio/sXLZyfL6a6imnlgG/_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/klio/sXLZyfL6a6imnlgG/_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/klio/sXLZyfL6a6imnlgG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Self-hosting Klio - Klio\">\u003cmeta data-mint-head property=\"og:description\" content=\"Run the open-source engine on your own hardware. One command brings up the stack and wires your agents to it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Klio\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.klio.tech/self-host/install\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://klio.mintlify.site/_mintlify/api/og/v2?division=Self-hosting\u0026amp;title=Self-hosting+Klio\u0026amp;description=Run+the+open-source+engine+on+your+own+hardware.+One+command+brings+up+the+stack+and+wires+your+agents+to+it.\u0026amp;theme=4ca2b43cfbceb6173d9675dc\u0026amp;signature=445ae8476e7c9a13025b40292cd2f04797f861f462c1ff840ddf5ad1c4575433\">\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=\"Self-hosting Klio - Klio\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Run the open-source engine on your own hardware. One command brings up the stack and wires your agents to it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://klio.mintlify.site/_mintlify/api/og/v2?division=Self-hosting\u0026amp;title=Self-hosting+Klio\u0026amp;description=Run+the+open-source+engine+on+your+own+hardware.+One+command+brings+up+the+stack+and+wires+your+agents+to+it.\u0026amp;theme=4ca2b43cfbceb6173d9675dc\u0026amp;signature=445ae8476e7c9a13025b40292cd2f04797f861f462c1ff840ddf5ad1c4575433\">\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/klio/sXLZyfL6a6imnlgG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Klio\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#B0421A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.klio.tech/self-host/install\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/self-host/install.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.klio.tech/#organization\",\"name\":\"Klio\",\"url\":\"https://docs.klio.tech\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/klio/ePftTmJOPX2G0TAF/logo/light.svg?fit=max\u0026auto=format\u0026n=ePftTmJOPX2G0TAF\u0026q=85\u0026s=e37298d4e5f0c0cec586c9cb935a5448\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.klio.tech#website\",\"name\":\"Klio\",\"url\":\"https://docs.klio.tech\",\"publisher\":{\"@id\":\"https://docs.klio.tech/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.klio.tech/self-host/install#webpage\",\"url\":\"https://docs.klio.tech/self-host/install\",\"name\":\"Self-hosting Klio\",\"description\":\"Run the open-source engine on your own hardware. One command brings up the stack and wires your agents to it.\",\"dateModified\":\"2026-08-11T14:40:16.836Z\",\"isPartOf\":{\"@id\":\"https://docs.klio.tech#website\"},\"breadcrumb\":{\"@id\":\"https://docs.klio.tech/self-host/install#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.klio.tech/self-host/install#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Klio\",\"item\":\"https://docs.klio.tech\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Self-hosting Klio\",\"item\":\"https://docs.klio.tech/self-host/install\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.klio.tech/self-host/install#article\",\"headline\":\"Self-hosting Klio\",\"name\":\"Self-hosting Klio\",\"description\":\"Run the open-source engine on your own hardware. One command brings up the stack and wires your agents to it.\",\"url\":\"https://docs.klio.tech/self-host/install\",\"mainEntityOfPage\":{\"@id\":\"https://docs.klio.tech/self-host/install#webpage\"},\"dateModified\":\"2026-08-11T14:40:16.836Z\",\"publisher\":{\"@id\":\"https://docs.klio.tech/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.klio.tech#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Klio\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Klio\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/self-host/install.md","siteName":"Klio","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/klio-tech/klio"},{"anchor":"Dashboard","icon":"gauge","href":"https://app.klio.tech"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Get started","pages":[{"title":"What is Klio?","sidebarTitle":"Introduction","href":""},{"title":"Quickstart","href":"/quickstart"}]},{"group":"Concepts","pages":[{"title":"The handover loop","href":"/concepts/handover-loop"},{"title":"Scope and spaces","href":"/concepts/scope"},{"title":"What Klio keeps","href":"/concepts/what-klio-keeps"},{"title":"Artifacts","href":"/concepts/artifacts"}]},{"group":"Connect an agent","pages":[{"title":"Claude Code","href":"/connect/claude-code"},{"title":"Cursor","href":"/connect/cursor"},{"title":"Any MCP client","description":"Klio is a standard Streamable HTTP MCP server — anything that speaks the protocol can join.","href":"/connect/any-mcp-client"}]},{"group":"Self-hosting","pages":[{"title":"Self-hosting Klio","href":"/self-host/install"},{"title":"CLI reference","description":"Every command and flag in the klio launcher.","href":"/self-host/cli"}]}]},{"tab":"Tool reference","pages":[{"title":"Tool reference","href":"/tools/overview"}]}]},"basePath":"","title":"Self-hosting Klio - Klio","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}