When the cluster has no room for an app’s pods, and how to add capacity.
Coming in the first release. This page describes behaviour being built for the first Gliss release. Details may change before it ships.
A diagnosis links here when pods stay Pending because no node has enough free CPU or memory, for example:
2 of 3 api pods are Pending: no node has 512Mi of free memory. This is a cluster capacity problem, not the app's.
If you are a builder: this is not your app’s problem, and your AI cannot fix it. Tell your IT team or the maintainer named in the diagnosis.If you maintain the platform: raise the node group’s maximum size, or add capacity through a platform release. Check whether one app’s requests grew unexpectedly before adding nodes.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Gliss","description":"Your AI writes the app. Gliss makes it real.","colors":{"primary":"#0D7A68","light":"#3CC6AB","dark":"#0D7A68"},"logo":{"light":"https://mintcdn.com/gliss/axEaheOfhsLFc7KM/logo/light.svg?fit=max\u0026auto=format\u0026n=axEaheOfhsLFc7KM\u0026q=85\u0026s=aaec7156e26ffaa5929b733c57e9af33","dark":"https://mintcdn.com/gliss/axEaheOfhsLFc7KM/logo/dark.svg?fit=max\u0026auto=format\u0026n=axEaheOfhsLFc7KM\u0026q=85\u0026s=b84d3f67c5c71daadd657a5ded1ac09e"},"favicon":"https://mintcdn.com/gliss/jqMn0p3U0Lw4yeV5/logo/favicon.svg?fit=max\u0026auto=format\u0026n=jqMn0p3U0Lw4yeV5\u0026q=85\u0026s=7805f3e55e297f44530af974483b07bc","footer":{"socials":{"website":"https://glissando.dev"}},"contextual":{"options":["copy","view","claude","chatgpt","cursor"],"display":"header"},"markdown":{"instructions":["If you are an AI assistant asked to build, change or ship a Gliss app, read the For AI agents page first (/for-ai-agents.md on this site) and follow its steps.","Inside an app's folder, the app's own AGENTS.md is the authority; `gliss guide` prints it. Never ask the user for a secret's value."]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gliss","hasAudioNarration":false,"actualSubdomain":"gliss","customDomains":["docs.glissando.dev"],"gitSource":{"type":"github","owner":"incredibuild-rnd","repo":"gliss-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae3881e3decdc5d1ba56074","collectionId":"6ebd61ff-1a07-48f8-b9f3-9b0d97c5fc73","liveDeploymentHistoryId":"6ae3881e3decdc5d1ba56074","schemaVersion":"v3"},"entitlements":{},"buildId":"6ae3881e3decdc5d1ba56074","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Documentation","count":39},{"language":"default","tag":"Build apps","count":13},{"language":"default","tag":"Engineers","count":10},{"language":"default","tag":"Administer","count":9},{"language":"default","tag":"Reference","count":9},{"language":"default","tag":"Capabilities","count":7},{"language":"default","tag":"Get started","count":5},{"language":"default","tag":"Files","count":5},{"language":"default","tag":"Tools","count":4},{"language":"default","tag":"Troubleshooting","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"maintenance/capacity","slug":"/maintenance/capacity","pageMetadata":{"title":"Capacity","description":"When the cluster has no room for an app's pods, and how to add capacity.","tag":"Demo","href":"/maintenance/capacity"},"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: \"When the cluster has no room for an app’s pods, and how to add capacity.\"\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={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Info}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Coming in the first release.`}),` This page describes behaviour being built for the first Gliss release. Details may change before it ships.`]})}),`\n`,_jsxs(_components.p,{children:[`A diagnosis links here when pods stay `,_jsx(_components.strong,{children:`Pending`}),` because no node has enough free CPU or memory, for example:`]}),`\n`,_jsx(CodeBlock,{filename:``,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:`2 of 3 api pods are Pending: no node has 512Mi of free memory. This is a cluster capacity problem, not the app's.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`If you are a builder:`}),` this is not your app’s problem, and your AI cannot fix it. Tell your IT team or the maintainer named in the diagnosis.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`If you maintain the platform:`}),` raise the node group’s maximum size, or add capacity through a platform release. Check whether one app’s requests grew unexpectedly before adding nodes.`]})]})}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":"Capacity","description":"When the cluster has no room for an app's pods, and how to add capacity.","tag":"Demo","href":"/maintenance/capacity"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"gliss","siteName":"Gliss","title":"Capacity - Gliss","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-05T10:35:06.667Z","originalFileLocation":"maintenance/capacity.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=\"When the cluster has no room for an app\u0026#x27;s pods, and how to add capacity.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Gliss\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gliss/bK94XtMsLyt74fEV/_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/gliss/bK94XtMsLyt74fEV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gliss/bK94XtMsLyt74fEV/_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/gliss/bK94XtMsLyt74fEV/_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/gliss/bK94XtMsLyt74fEV/_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/gliss/bK94XtMsLyt74fEV/_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/gliss/bK94XtMsLyt74fEV/_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/gliss/bK94XtMsLyt74fEV/_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/gliss/bK94XtMsLyt74fEV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Capacity - Gliss\">\u003cmeta data-mint-head property=\"og:description\" content=\"When the cluster has no room for an app\u0026#x27;s pods, and how to add capacity.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Gliss\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.glissando.dev/maintenance/capacity\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gliss.mintlify.app/_mintlify/api/og/v2?division=Troubleshooting\u0026amp;title=Capacity\u0026amp;description=When+the+cluster+has+no+room+for+an+app%27s+pods%2C+and+how+to+add+capacity.\u0026amp;theme=452b1c125b48a6dff629143f\u0026amp;signature=4158fa3764cf0c12711e91d7f0837c24da237bff25943fd2e311674832afcd0e\">\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=\"Capacity - Gliss\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"When the cluster has no room for an app\u0026#x27;s pods, and how to add capacity.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gliss.mintlify.app/_mintlify/api/og/v2?division=Troubleshooting\u0026amp;title=Capacity\u0026amp;description=When+the+cluster+has+no+room+for+an+app%27s+pods%2C+and+how+to+add+capacity.\u0026amp;theme=452b1c125b48a6dff629143f\u0026amp;signature=4158fa3764cf0c12711e91d7f0837c24da237bff25943fd2e311674832afcd0e\">\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/gliss/bK94XtMsLyt74fEV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Gliss\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D7A68\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.glissando.dev/maintenance/capacity\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/maintenance/capacity.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.glissando.dev/#organization\",\"name\":\"Gliss\",\"url\":\"https://docs.glissando.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gliss/axEaheOfhsLFc7KM/logo/light.svg?fit=max\u0026auto=format\u0026n=axEaheOfhsLFc7KM\u0026q=85\u0026s=aaec7156e26ffaa5929b733c57e9af33\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.glissando.dev#website\",\"name\":\"Gliss\",\"url\":\"https://docs.glissando.dev\",\"publisher\":{\"@id\":\"https://docs.glissando.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.glissando.dev/maintenance/capacity#webpage\",\"url\":\"https://docs.glissando.dev/maintenance/capacity\",\"name\":\"Capacity\",\"description\":\"When the cluster has no room for an app's pods, and how to add capacity.\",\"dateModified\":\"2026-10-05T10:35:06.667Z\",\"isPartOf\":{\"@id\":\"https://docs.glissando.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.glissando.dev/maintenance/capacity#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.glissando.dev/maintenance/capacity#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Troubleshooting\",\"item\":\"https://docs.glissando.dev/troubleshooting/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Capacity\",\"item\":\"https://docs.glissando.dev/maintenance/capacity\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.glissando.dev/maintenance/capacity#article\",\"headline\":\"Capacity\",\"name\":\"Capacity\",\"description\":\"When the cluster has no room for an app's pods, and how to add capacity.\",\"url\":\"https://docs.glissando.dev/maintenance/capacity\",\"mainEntityOfPage\":{\"@id\":\"https://docs.glissando.dev/maintenance/capacity#webpage\"},\"dateModified\":\"2026-10-05T10:35:06.667Z\",\"publisher\":{\"@id\":\"https://docs.glissando.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.glissando.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Gliss\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Gliss","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get started","pages":[{"title":"What is Gliss","href":""},{"title":"How Gliss works","href":"/get-started/how-it-works"},{"title":"Quickstart","tag":"Demo","href":"/get-started/quickstart"},{"title":"For AI agents","tag":"Demo","href":"/for-ai-agents"},{"title":"Concepts","href":"/get-started/concepts"}]},{"group":"Build apps","pages":[{"title":"Writing gliss.yaml","tag":"Available","href":"/build/gliss-yaml"},{"group":"Capabilities","pages":[{"title":"Postgres","tag":"Demo","href":"/build/capabilities/postgres"},{"title":"Redis","tag":"Planned","href":"/build/capabilities/redis"},{"title":"Bucket","tag":"Demo","href":"/build/capabilities/bucket"},{"title":"Hostname","tag":"Demo","href":"/build/capabilities/hostname"},{"title":"Sign-in (SSO)","tag":"Planned","href":"/build/capabilities/sso"},{"title":"Secrets","tag":"Demo","href":"/build/capabilities/secrets"},{"title":"Healer","tag":"Planned","href":"/build/capabilities/healer"}]},{"title":"Preview, Beta and Live","tag":"Demo","href":"/build/stages"},{"title":"Share and publish","tag":"Demo","href":"/build/share-and-publish"},{"title":"Secrets and mock mode","tag":"Demo","href":"/build/secrets-and-mock-mode"},{"title":"Diagnostics with your AI","tag":"Demo","href":"/build/diagnostics"},{"title":"Supported AI tools","tag":"Demo","href":"/build/ai-tools"}]},{"group":"Administer","pages":[{"title":"Install Gliss","tag":"Demo","href":"/administer/install"},{"title":"The Gliss GitHub App","tag":"Demo","href":"/administer/github-app"},{"title":"The catalog","tag":"Available","href":"/administer/catalog"},{"title":"Approvals","tag":"Planned","href":"/administer/approvals"},{"title":"Sign-in and SSO","tag":"Planned","href":"/administer/sign-in"},{"title":"Outbound access","tag":"Planned","href":"/administer/egress"},{"title":"Support access","tag":"Planned","href":"/administer/support-access"},{"title":"Maintenance tiers","tag":"Planned","href":"/administer/maintenance"},{"title":"Security model","tag":"Demo","href":"/administer/security-model"}]},{"group":"Engineers","pages":[{"title":"Levels 1 and 2","tag":"Planned","href":"/engineers/levels"},{"title":"garden.yml with Gliss action types","tag":"Planned","href":"/engineers/garden-yml"},{"title":"Garden basics","tag":"Planned","href":"/engineers/garden-basics"},{"title":"Building containers","tag":"Planned","href":"/engineers/building-containers"},{"title":"Tests and runs","tag":"Planned","href":"/engineers/tests"},{"title":"Caching","tag":"Planned","href":"/engineers/caching"},{"title":"Variables and templating","tag":"Planned","href":"/engineers/variables-and-templating"},{"title":"Helm charts","tag":"Planned","href":"/engineers/helm"},{"title":"Kubernetes manifests","tag":"Planned","href":"/engineers/kubernetes-manifests"},{"title":"CI with GitHub Actions","tag":"Planned","href":"/engineers/ci"}]},{"group":"Troubleshooting","pages":[{"title":"Troubleshooting","description":"Reading a diagnosis, and what to do for each kind of failure.","tag":"Demo","href":"/troubleshooting/overview"},{"title":"Capacity","tag":"Demo","href":"/maintenance/capacity"}]}]},{"tab":"Reference","pages":[{"title":"Reference","href":"/reference/gliss-yaml"}]}]},"title":"Capacity - Gliss","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":[],"chunks":[]}