Approve or deny a protected-environment deploy directly from the Slack or Discord notification, without opening the dashboard.
When a deploy or promotion targets a protected environment, Levelrail requires a second, distinct user to approve it (see Deploy safety for the two-person gate). By default an approver opens the dashboard’s Approvals queue. This feature adds Approve and Deny buttons to the Slack or Discord message Levelrail sends when a request comes in, so an approver can decide from a phone.It is an opt-in addition to an existing notification channel (Settings > Notification channels), not a separate integration. Connect a Slack or Discord channel the normal way first, then turn on Interactive approval buttons on that channel’s edit dialog. It is off by default, and the toggle requires the secret from the platform setup below, because without one there is nothing to verify an incoming click against.
Set up the platform
Slack
Discord
Levelrail’s Slack channel sends through an Incoming Webhook. To receive button clicks, that webhook must belong to a Slack app with Interactivity turned on.
Under Basic Information, copy the Signing Secret and paste it into the channel’s interactive approval secret field. Levelrail uses it to verify that a click came from your Slack app.
4
Check webhook ownership
Make sure the same app owns the Incoming Webhook URL the channel is configured with.
Discord’s equivalent of a Request URL is an application’s Interactions Endpoint URL, and verification uses the application’s public key instead of a shared secret.
1
Copy the public key
Open your application at https://discord.com/developers/applications (the one your Incoming Webhook belongs to). Under General Information, copy the Public Key and paste it into the channel’s interactive approval secret field. Save the channel with interactive approvals on first.
Discord sends a verification ping when you save and refuses the URL if the ping is not answered correctly, so the key must already be saved in Levelrail.
What it does
A deploy or promotion that needs approval posts a message with Approve and Deny buttons to every channel that has this turned on.
A click decides the approval through the same code path as the dashboard’s buttons: the same not-pending check, the same rule that the requester cannot approve their own request, and the same freeze gate. It cannot apply a change the dashboard would not allow.
A forged or replayed request cannot approve anything. Every incoming request is signature-verified against the channel’s own secret first, and an already-decided approval cannot be decided again (a second click or a retried delivery is told it is no longer pending).
Identity scopeLevelrail has no link between a Slack or Discord user and a Levelrail account. A verified click is authorized at the channel level: anyone who can click the button in that Slack channel or Discord server can decide the approval. The clicking user’s name is recorded on the decision for visibility, but it does not authorize it. Treat the channel or server you point this at as the trust boundary.
Anyone in the Slack or Discord channel, including the person who requested the deploy, can approve a protected deploy from chat. A chat click decides as the channel, not as a person, so the requester’s self-approval check cannot match it. For approvals that need true separation of duties, approve only from the dashboard or the CLI, and leave Interactive approval buttons off on every channel (it is off by default; there is no global switch).
Because of that, only a caller with the root ability can turn interactive approvals on, change the interactive secret, or change the webhook URL of a channel that has them on. Other channel edits keep their usual write ability. Anyone else gets a 403. Channels that already have interactive approvals on keep working until a root user turns them off.
Endpoints
Platform
Endpoint
Auth
Slack
POST /api/v1/webhooks/slack/interactions
X-Slack-Signature and X-Slack-Request-Timestamp, HMAC-SHA256 against the channel’s signing secret
Discord
POST /api/v1/webhooks/discord/interactions
X-Signature-Ed25519 and X-Signature-Timestamp, Ed25519 against the channel’s public key
Neither route uses a session or API token, like POST /api/v1/webhooks/github/{name}, because neither platform can present one. The signature check stands in for auth, and a request that fails it is rejected with no state change.
Last modified on October 31, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Levelrail","description":"Self-hosted deployment platform. Push to git, get a running app with TLS, logs, metrics and rollback. One Go binary, no Kubernetes.","colors":{"primary":"#107292","light":"#2FB3DC","dark":"#084F67"},"logo":{"light":"https://mintcdn.com/levelrail/56HjW70mOjUmjIrm/assets/brand/wordmark-light.svg?fit=max\u0026auto=format\u0026n=56HjW70mOjUmjIrm\u0026q=85\u0026s=cbe02b3c3d17b11f9cc5a18551a30782","dark":"https://mintcdn.com/levelrail/56HjW70mOjUmjIrm/assets/brand/wordmark-dark.svg?fit=max\u0026auto=format\u0026n=56HjW70mOjUmjIrm\u0026q=85\u0026s=a4aa78b496c43e0a5edd9dffce778a45","href":"https://levelrail.com"},"favicon":"https://mintcdn.com/levelrail/zPhEnShTGkGFCjPc/public/favicon.svg?fit=max\u0026auto=format\u0026n=zPhEnShTGkGFCjPc\u0026q=85\u0026s=65f3143dd7539d4b1d34090204f05be0","appearance":{"default":"dark","strict":false},"background":{"color":{"light":"#ffffff","dark":"#000000"}},"navbar":{"links":[{"icon":"globe","href":"https://levelrail.com","label":"Website"},{"icon":"clock-rotate-left","href":"/changelog","label":"Changelog"},{"icon":"github","href":"https://github.com/glincker/levelrail","label":"GitHub"}],"primary":{"type":"button","label":"Get started","href":"/getting-started"}},"footer":{"socials":{"github":"https://github.com/glincker/levelrail","x":"https://x.com/thegdsks","website":"https://levelrail.com"}},"search":{"prompt":"Search docs, CLI, API, guides"},"seo":{"metatags":{"og:site_name":"Levelrail Docs","og:type":"website","og:image":"https://docs.levelrail.com/public/og/default.png","og:image:width":"1200","og:image:height":"630","twitter:card":"summary_large_image","twitter:image":"https://docs.levelrail.com/public/og/default.png","twitter:site":"@thegdsks","keywords":"self-hosted PaaS, Coolify alternative, Docker deployment platform, self-hosted deploys, Levelrail"},"indexing":"navigable"},"fonts":{"heading":{"family":"Geist","weight":500},"body":{"family":"Geist"}},"styling":{"codeblocks":"dark","latex":true},"errors":{"404":{"redirect":false,"title":"Page not found","description":"This page moved or never existed. Try the [quickstart](/getting-started), the [all pages index](/all-pages) or search above."}},"contextual":{"options":["copy","view","chatgpt","claude","cursor","mcp"],"display":"header"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"levelrail","hasAudioNarration":false,"actualSubdomain":"levelrail","customDomains":["docs.levelrail.com"],"gitSource":{"type":"github","owner":"glincker","repo":"levelrail","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afbaaa0074d6c6a87c9ab92","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Self-host gallery","count":575},{"language":"default","tag":"How-to guides","count":255},{"language":"default","tag":"Productivity","count":86},{"language":"default","tag":"Developer Tools","count":82},{"language":"default","tag":"Get started","count":57},{"language":"default","tag":"Deploying","count":56},{"language":"default","tag":"Database Tools","count":50},{"language":"default","tag":"AI","count":48},{"language":"default","tag":"Monitoring","count":48},{"language":"default","tag":"Media","count":47}]},"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--lr-live: #2fb3dc;--lr-soft: #58b1ce;--lr-teal: #107292;--lr-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;--lr-r: 12px;--lr-face: #0e0f11;--lr-face-2: #141617;--lr-text: #cfcfd3;--lr-link: #58b1ce;--lr-line: rgba(255, 255, 255, 0.08);--lr-ring: linear-gradient(180deg, rgba(255, 255, 255, 0.18), rgba(255, 255, 255, 0.04) 40%, rgba(255, 255, 255, 0.06));--lr-ring-hot: linear-gradient(180deg, rgba(47, 179, 220, 0.55), rgba(47, 179, 220, 0.12) 45%, rgba(47, 179, 220, 0.2));--lr-sheen: linear-gradient(180deg, rgba(255, 255, 255, 0.035), rgba(255, 255, 255, 0));--lr-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.07), 0 1px 1px rgba(0, 0, 0, 0.5), 0 8px 16px -4px rgba(0, 0, 0, 0.55), 0 24px 48px -12px rgba(0, 0, 0, 0.65);--lr-glow-op: 1;--lr-grain: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='220' height='220'%3E%3Cfilter id='n' x='0' y='0' width='100%25' height='100%25'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.9' numOctaves='2' stitchTiles='stitch'/%3E%3CfeColorMatrix values='0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 9 0 0 0 -4.3'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)'/%3E%3C/svg%3E\")}html:not(.dark){--lr-face: #ffffff;--lr-face-2: #f6f6f7;--lr-text: #3a3d40;--lr-link: #107292;--lr-line: rgba(14, 15, 17, 0.1);--lr-ring: linear-gradient(180deg, rgba(14, 15, 17, 0.2), rgba(14, 15, 17, 0.08) 40%, rgba(14, 15, 17, 0.1));--lr-ring-hot: linear-gradient(180deg, rgba(16, 114, 146, 0.6), rgba(16, 114, 146, 0.18) 45%, rgba(16, 114, 146, 0.26));--lr-sheen: linear-gradient(180deg, rgba(255, 255, 255, 0.9), rgba(255, 255, 255, 0));--lr-shadow: 0 1px 1px rgba(14, 15, 17, 0.06), 0 8px 16px -6px rgba(14, 15, 17, 0.1);--lr-glow-op: 0.35}html.dark body{background-color:#000}body{position:relative;font-feature-settings:\"cv11\", \"ss03\";-webkit-font-smoothing:antialiased}body::before,body::after{content:\"\";position:absolute;inset:0 0 auto 0;height:440px;z-index:-1;pointer-events:none;background:radial-gradient(54% 92% at 50% 0%, rgba(47, 179, 220, 0.42), transparent 72%),\n radial-gradient(38% 78% at 10% 0%, rgba(31, 200, 176, 0.3), transparent 72%),\n radial-gradient(36% 70% at 92% 0%, rgba(108, 125, 255, 0.3), transparent 72%)}body::before{opacity:calc(0.4 * var(--lr-glow-op))}body::after{opacity:calc(0.9 * var(--lr-glow-op));filter:saturate(1.2) brightness(1.25);-webkit-mask-image:var(--lr-grain), linear-gradient(to bottom, #000 0%, transparent 88%);-webkit-mask-size:220px 220px, 100% 100%;-webkit-mask-composite:source-in;mask-image:var(--lr-grain), linear-gradient(to bottom, #000 0%, transparent 88%);mask-size:220px 220px, 100% 100%;mask-composite:intersect}html{isolation:isolate}#content-area,#content-container{color:var(--lr-text)}#page-title{font-weight:300;letter-spacing:-0.03em;line-height:1.08;text-wrap:balance}#content-area h2{font-weight:300;letter-spacing:-0.025em}#content-area h3,#content-area h4{font-weight:500;letter-spacing:-0.02em}#header p,#content-area p{text-wrap:pretty}#header>div>div:first-child:not(:has(h1)){font-family:var(--lr-mono);font-size:0.75rem;letter-spacing:0.08em;text-transform:uppercase;color:#8d8d96}#content-area a:not(.card):not([data-component-part]){color:var(--lr-link)}#content-area a[href]:not(.card){text-decoration-color:color-mix(in srgb, var(--lr-link) 40%, transparent)}#content-area a[href]:not(.card):hover{text-decoration-color:currentColor}code,pre,kbd,samp{font-family:var(--lr-mono)!important;font-feature-settings:\"calt\" 0}#content-area :not(pre)>code{background:var(--lr-face-2);border:1px solid var(--lr-line);border-radius:6px;padding:0.1em 0.4em;font-size:0.875em;color:inherit}html.dark #content-area :not(pre)>code{color:#e4e4e7}.code-block{border-radius:var(--lr-r);border:1px solid transparent;box-shadow:var(--lr-shadow);background:var(--lr-sheen) padding-box, linear-gradient(#08090a, #08090a) padding-box, var(--lr-ring) border-box}.code-block-background,.code-block>div{border-radius:var(--lr-r);background-color:transparent}.code-block [data-component-part=\"code-block-root\"],.code-block pre{background:transparent}.code-block code{font-size:0.8125rem;line-height:1.7}.card,.accordion,.accordion-group,.callout{border:1px solid transparent;border-radius:var(--lr-r);box-shadow:var(--lr-shadow);background:var(--lr-sheen) padding-box, linear-gradient(var(--lr-face), var(--lr-face)) padding-box, var(--lr-ring) border-box}.card{transition:box-shadow 0.2s, transform 0.2s}.card:hover{transform:translateY(-1px)}html.dark .card:hover{border-color:rgba(47, 179, 220, 0.45)}.card [data-component-part=\"card-title\"]{font-weight:500;letter-spacing:-0.01em}.card [data-component-part=\"card-icon\"]{color:var(--lr-live)}html:not(.dark) .card [data-component-part=\"card-icon\"]{color:#107292}.accordion{margin-bottom:0.75rem;overflow:hidden}.accordion-group{overflow:hidden}.callout{padding:1rem 1.25rem}.callout[class*=\"border-yellow\"],.callout[class*=\"border-green\"],.callout[class*=\"border-blue\"],.callout[class*=\"border-red\"],.callout[class*=\"border-sky\"]{background:var(--lr-sheen) padding-box, linear-gradient(var(--lr-face), var(--lr-face)) padding-box, var(--lr-ring) border-box}@media (prefers-reduced-motion: reduce){.card{transition:none}.card:hover{transform:none}}#content-area table{border-collapse:separate;border-spacing:0;border:1px solid var(--lr-line);border-radius:var(--lr-r);overflow:hidden;box-shadow:var(--lr-shadow)}#content-area thead th{font-family:var(--lr-mono);font-size:0.75rem;font-weight:500;letter-spacing:0.06em;text-transform:uppercase;color:#8d8d96;background:var(--lr-face-2)}#content-area tbody td,#content-area thead th{border-bottom:1px solid var(--lr-line)}#content-area tbody tr:last-child td{border-bottom:0}#navbar>div.absolute,#navbar>div>div.absolute{background:color-mix(in srgb, var(--lr-face) 38%, transparent);border-bottom-color:var(--lr-line);backdrop-filter:blur(20px) saturate(1.3);-webkit-backdrop-filter:blur(20px) saturate(1.3)}#sidebar .sticky.pointer-events-none{background:none}#navbar .nav-tabs-item[data-active=\"true\"]{color:var(--lr-live)}html:not(.dark) #navbar .nav-tabs-item[data-active=\"true\"]{color:#107292}#navbar .nav-tabs-item[data-active=\"true\"]>div,#navbar .nav-tabs-item[data-active=\"true\"]::after{background:var(--lr-live)}html:not(.dark) #navbar .nav-tabs-item[data-active=\"true\"]>div,html:not(.dark) #navbar .nav-tabs-item[data-active=\"true\"]::after{background:#107292}#topbar-cta-button a>span.absolute{border-radius:50px;background:var(--lr-live);border:1px solid rgba(255, 255, 255, 0.35);box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.55), inset 0 -2px 0 rgba(0, 0, 0, 0.18), 0 6px 14px -6px rgba(47, 179, 220, 0.45)}#topbar-cta-button a{padding-left:1rem;padding-right:0.75rem}#topbar-cta-button a .text-white,#topbar-cta-button a svg{color:#000!important}html:not(.dark) #topbar-cta-button a>span.absolute{background:#06232c;border-color:transparent;box-shadow:0 1px 1px rgba(14, 15, 17, 0.3)}html:not(.dark) #topbar-cta-button a .text-white,html:not(.dark) #topbar-cta-button a svg{color:#2fb3dc!important}#search-bar-entry{border-radius:50px;border:1px solid transparent;box-shadow:var(--lr-shadow);background:var(--lr-sheen) padding-box, linear-gradient(var(--lr-face-2), var(--lr-face-2)) padding-box, var(--lr-ring) border-box}#search-bar-entry:hover{background:var(--lr-sheen) padding-box, linear-gradient(var(--lr-face-2), var(--lr-face-2)) padding-box, var(--lr-ring-hot) border-box}#sidebar .sidebar-group-header{font-family:var(--lr-mono);font-size:0.6875rem;letter-spacing:0.08em;text-transform:uppercase;font-weight:500;color:#8d8d96}#sidebar a[aria-current=\"page\"]{border-radius:50px;color:var(--lr-live);background:rgba(47, 179, 220, 0.08);box-shadow:inset 0 0 0 1px rgba(47, 179, 220, 0.2)}html:not(.dark) #sidebar a[aria-current=\"page\"]{color:#084f67;background:rgba(16, 114, 146, 0.09);box-shadow:inset 0 0 0 1px rgba(16, 114, 146, 0.25)}#sidebar a:not([aria-current=\"page\"]):hover{border-radius:50px}#table-of-contents a[data-active=\"true\"],#table-of-contents .toc-item[data-active=\"true\"]{color:var(--lr-live)}html:not(.dark) #table-of-contents a[data-active=\"true\"]{color:#107292}#footer{border-top:1px solid var(--lr-line)}#content-area table th,#content-area table td{padding:0.75rem 1rem;vertical-align:top}#content-area table td:first-child{font-weight:500}#sidebar a[aria-current=\"page\"] img[src*=\"/assets/icons/\"],#navbar .nav-tabs-item[data-active=\"true\"] img[src*=\"/assets/icons/\"]{filter:brightness(0) saturate(100%) invert(58%) sepia(96%) saturate(237%) hue-rotate(148deg) brightness(81%) contrast(149%)}html:not(.dark) #sidebar a[aria-current=\"page\"] img[src*=\"/assets/icons/\"],html:not(.dark) #navbar .nav-tabs-item[data-active=\"true\"] img[src*=\"/assets/icons/\"]{filter:brightness(0) saturate(100%) invert(28%) sepia(90%) saturate(323%) hue-rotate(148deg) brightness(118%) contrast(123%)}"}],"page":{"pagePath":"chat-deploy-approvals","slug":"/chat-deploy-approvals","pageMetadata":{"title":"Chat-interactive deploy approvals","sidebarTitle":"Chat approvals","description":"Approve or deny a protected-environment deploy directly from the Slack or Discord notification, without opening the dashboard.","og:url":"https://docs.levelrail.com/chat-deploy-approvals","href":"/chat-deploy-approvals"},"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: \"Approve or deny a protected-environment deploy directly from the Slack or Discord notification, without opening the dashboard.\"\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`,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},{CodeBlock,Heading,Step,Steps,Tab,Table,Tabs,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`When a deploy or promotion targets a protected environment, Levelrail requires a second, distinct user to approve it (see `,_jsx(_components.a,{href:`/deploy-safety`,children:`Deploy safety`}),` for the two-person gate). By default an approver opens the dashboard’s Approvals queue. This feature adds Approve and Deny buttons to the Slack or Discord message Levelrail sends when a request comes in, so an approver can decide from a phone.`]}),`\n`,_jsxs(_components.p,{children:[`It is an opt-in addition to an existing notification channel (`,_jsx(_components.strong,{children:`Settings > Notification channels`}),`), not a separate integration. Connect a Slack or Discord channel the normal way first, then turn on `,_jsx(_components.strong,{children:`Interactive approval buttons`}),` on that channel’s edit dialog. It is off by default, and the toggle requires the secret from the platform setup below, because without one there is nothing to verify an incoming click against.`]}),`\n`,_jsx(Heading,{level:`2`,id:`set-up-the-platform`,children:`Set up the platform`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Slack`,id:`slack`,children:[_jsxs(_components.p,{children:[`Levelrail’s Slack channel sends through an Incoming Webhook. To receive button clicks, that webhook must belong to a Slack app with `,_jsx(_components.strong,{children:`Interactivity`}),` turned on.`]}),_jsxs(Steps,{children:[_jsx(Step,{title:`Open your Slack app`,children:_jsxs(_components.p,{children:[`Create one at `,_jsx(_components.a,{href:`https://api.slack.com/apps`,children:`https://api.slack.com/apps`}),`, or use the app your Incoming Webhook already belongs to.`]})}),_jsxs(Step,{title:`Set the Request URL`,children:[_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Interactivity \u0026 Shortcuts`}),`, turn Interactivity on and set the Request URL to:`]}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://\u003cyour-levelrail-host>/api/v1/webhooks/slack/interactions`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsx(Step,{title:`Copy the signing secret`,children:_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Basic Information`}),`, copy the `,_jsx(_components.strong,{children:`Signing Secret`}),` and paste it into the channel’s interactive approval secret field. Levelrail uses it to verify that a click came from your Slack app.`]})}),_jsx(Step,{title:`Check webhook ownership`,children:_jsx(_components.p,{children:`Make sure the same app owns the Incoming Webhook URL the channel is configured with.`})})]})]}),_jsxs(Tab,{title:`Discord`,id:`discord`,children:[_jsx(_components.p,{children:`Discord’s equivalent of a Request URL is an application’s Interactions Endpoint URL, and verification uses the application’s public key instead of a shared secret.`}),_jsxs(Steps,{children:[_jsx(Step,{title:`Copy the public key`,children:_jsxs(_components.p,{children:[`Open your application at `,_jsx(_components.a,{href:`https://discord.com/developers/applications`,children:`https://discord.com/developers/applications`}),` (the one your Incoming Webhook belongs to). Under `,_jsx(_components.strong,{children:`General Information`}),`, copy the `,_jsx(_components.strong,{children:`Public Key`}),` and paste it into the channel’s interactive approval secret field. Save the channel with interactive approvals on first.`]})}),_jsxs(Step,{title:`Set the Interactions Endpoint URL`,children:[_jsx(_components.p,{children:`Set it to:`}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://\u003cyour-levelrail-host>/api/v1/webhooks/discord/interactions`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`Discord sends a verification ping when you save and refuses the URL if the ping is not answered correctly, so the key must already be saved in Levelrail.`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`what-it-does`,children:`What it does`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`A deploy or promotion that needs approval posts a message with `,_jsx(_components.strong,{children:`Approve`}),` and `,_jsx(_components.strong,{children:`Deny`}),` buttons to every channel that has this turned on.`]}),`\n`,_jsx(_components.li,{children:`A click decides the approval through the same code path as the dashboard’s buttons: the same not-pending check, the same rule that the requester cannot approve their own request, and the same freeze gate. It cannot apply a change the dashboard would not allow.`}),`\n`,_jsx(_components.li,{children:`A forged or replayed request cannot approve anything. Every incoming request is signature-verified against the channel’s own secret first, and an already-decided approval cannot be decided again (a second click or a retried delivery is told it is no longer pending).`}),`\n`]}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Identity scope`})}),_jsx(_components.p,{children:`Levelrail has no link between a Slack or Discord user and a Levelrail account. A verified click is authorized at the channel level: anyone who can click the button in that Slack channel or Discord server can decide the approval. The clicking user’s name is recorded on the decision for visibility, but it does not authorize it. Treat the channel or server you point this at as the trust boundary.`}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Anyone in the Slack or Discord channel, including the person who requested the deploy, can approve a protected deploy from chat. A chat click decides as the channel, not as a person, so the requester’s self-approval check cannot match it. For approvals that need true separation of duties, approve only from the dashboard or the CLI, and leave `,_jsx(_components.strong,{children:`Interactive approval buttons`}),` off on every channel (it is off by default; there is no global switch).`]})}),_jsxs(_components.p,{children:[`Because of that, only a caller with the `,_jsx(_components.code,{children:`root`}),` ability can turn interactive approvals on, change the interactive secret, or change the webhook URL of a channel that has them on. Other channel edits keep their usual `,_jsx(_components.code,{children:`write`}),` ability. Anyone else gets a 403. Channels that already have interactive approvals on keep working until a root user turns them off.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`endpoints`,children:`Endpoints`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Platform`}),_jsx(_components.th,{children:`Endpoint`}),_jsx(_components.th,{children:`Auth`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Slack`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /api/v1/webhooks/slack/interactions`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`X-Slack-Signature`}),` and `,_jsx(_components.code,{children:`X-Slack-Request-Timestamp`}),`, HMAC-SHA256 against the channel’s signing secret`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Discord`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /api/v1/webhooks/discord/interactions`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`X-Signature-Ed25519`}),` and `,_jsx(_components.code,{children:`X-Signature-Timestamp`}),`, Ed25519 against the channel’s public key`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Neither route uses a session or API token, like `,_jsx(_components.code,{children:`POST /api/v1/webhooks/github/{name}`}),`, because neither platform can present one. The signature check stands in for auth, and a request that fails it is rejected with no state change.`]})]})}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":"dark","config":{},"pageMetadata":{"title":"Chat-interactive deploy approvals","sidebarTitle":"Chat approvals","description":"Approve or deny a protected-environment deploy directly from the Slack or Discord notification, without opening the dashboard.","og:url":"https://docs.levelrail.com/chat-deploy-approvals","href":"/chat-deploy-approvals"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Set up the platform","slug":"set-up-the-platform","depth":2,"children":[]},{"title":"What it does","slug":"what-it-does","depth":2,"children":[]},{"title":"Endpoints","slug":"endpoints","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/levelrail/34332f0f5f6180ce/public/deploy.js"],"subdomain":"levelrail","siteName":"Levelrail","title":"Chat-interactive deploy approvals - Levelrail","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T17:48:52.028Z","gitLastModified":"2026-10-31T03:07:21.000Z","originalFileLocation":"chat-deploy-approvals.md"},"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=\"dark\"}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=\"Approve or deny a protected-environment deploy directly from the Slack or Discord notification, without opening the dashboard.\">\u003cmeta data-mint-head name=\"keywords\" content=\"self-hosted PaaS, Coolify alternative, Docker deployment platform, self-hosted deploys, Levelrail\">\u003cmeta data-mint-head name=\"application-name\" content=\"Levelrail\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/levelrail/sfnZeja47AHfK8h4/_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/levelrail/sfnZeja47AHfK8h4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/levelrail/sfnZeja47AHfK8h4/_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/levelrail/sfnZeja47AHfK8h4/_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/levelrail/sfnZeja47AHfK8h4/_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/levelrail/sfnZeja47AHfK8h4/_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/levelrail/sfnZeja47AHfK8h4/_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/levelrail/sfnZeja47AHfK8h4/_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/levelrail/sfnZeja47AHfK8h4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Chat-interactive deploy approvals - Levelrail\">\u003cmeta data-mint-head property=\"og:description\" content=\"Approve or deny a protected-environment deploy directly from the Slack or Discord notification, without opening the dashboard.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Levelrail Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.levelrail.com/chat-deploy-approvals\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.levelrail.com/public/og/default.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=\"Chat-interactive deploy approvals - Levelrail\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Approve or deny a protected-environment deploy directly from the Slack or Discord notification, without opening the dashboard.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.levelrail.com/public/og/default.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/levelrail/sfnZeja47AHfK8h4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Levelrail\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#107292\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.levelrail.com/chat-deploy-approvals\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/chat-deploy-approvals.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.levelrail.com/#organization\",\"name\":\"Levelrail\",\"url\":\"https://docs.levelrail.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/levelrail/56HjW70mOjUmjIrm/assets/brand/wordmark-light.svg?fit=max\u0026auto=format\u0026n=56HjW70mOjUmjIrm\u0026q=85\u0026s=cbe02b3c3d17b11f9cc5a18551a30782\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.levelrail.com#website\",\"name\":\"Levelrail\",\"url\":\"https://docs.levelrail.com\",\"publisher\":{\"@id\":\"https://docs.levelrail.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.levelrail.com/chat-deploy-approvals#webpage\",\"url\":\"https://docs.levelrail.com/chat-deploy-approvals\",\"name\":\"Chat-interactive deploy approvals\",\"description\":\"Approve or deny a protected-environment deploy directly from the Slack or Discord notification, without opening the dashboard.\",\"dateModified\":\"2026-10-31T03:07:21.000Z\",\"isPartOf\":{\"@id\":\"https://docs.levelrail.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.levelrail.com/chat-deploy-approvals#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.levelrail.com/chat-deploy-approvals#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Deploying\",\"item\":\"https://docs.levelrail.com/deploying-apps\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Chat-interactive deploy approvals\",\"item\":\"https://docs.levelrail.com/chat-deploy-approvals\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.levelrail.com/chat-deploy-approvals#article\",\"headline\":\"Chat-interactive deploy approvals\",\"name\":\"Chat-interactive deploy approvals\",\"description\":\"Approve or deny a protected-environment deploy directly from the Slack or Discord notification, without opening the dashboard.\",\"url\":\"https://docs.levelrail.com/chat-deploy-approvals\",\"mainEntityOfPage\":{\"@id\":\"https://docs.levelrail.com/chat-deploy-approvals#webpage\"},\"image\":\"https://docs.levelrail.com/public/og/default.png\",\"dateModified\":\"2026-10-31T03:07:21.000Z\",\"publisher\":{\"@id\":\"https://docs.levelrail.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.levelrail.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Levelrail\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Levelrail\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/chat-deploy-approvals.md","siteName":"Levelrail","nav":{"global":null,"tabs":[{"tab":"Get started","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/rocket-launch.svg","pages":[{"title":"Get started","href":""}]},{"tab":"How-to guides","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/book-open.svg","groups":[{"group":"Essentials","pages":[{"title":"Doctor and import from the command line","sidebarTitle":"Doctor and import CLI","href":"/doctor-and-import"},{"title":"Email notifications","href":"/email-notifications"},{"title":"Email templates and messages","href":"/email-templates"},{"title":"Alerts","sidebarTitle":"Alerts","href":"/alerts"},{"title":"Alert inbox","href":"/alert-inbox"},{"title":"Event webhooks","href":"/event-webhooks"},{"title":"Off-host heartbeat","href":"/heartbeat"},{"title":"Attention center","href":"/attention-center"},{"title":"Token expiry and rotation","href":"/token-expiry-and-rotation"}]},{"group":"Deploying","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/cloud-arrow-up.svg","pages":[{"title":"Deploying and managing apps","sidebarTitle":"Deploying apps","href":"/deploying-apps"},{"title":"Deploy from your computer","sidebarTitle":"Deploy from CLI","href":"/deploy-from-cli"},{"title":"Drop deploy for static sites","sidebarTitle":"Drop deploy","href":"/drop-deploy"},{"title":"Compose apps","href":"/compose-apps"},{"title":"Runtime options","href":"/runtime-options"},{"title":"App files","href":"/app-files"},{"title":"UDP published ports","href":"/udp-ports"},{"title":"New app wizard","href":"/new-app-wizard"},{"title":"Importing apps","href":"/importing-apps"},{"title":"Connect a Git source to an existing app","href":"/connect-git-source"},{"title":"Static pages","sidebarTitle":"Pages","href":"/pages"},{"title":"Static site routing rules","sidebarTitle":"Static routing","href":"/static-routing"},{"title":"Deploy safety","href":"/deploy-safety"},{"title":"Publish lock","href":"/publish-lock"},{"title":"Deploy failures","href":"/deploy-failures"},{"title":"Status reasons","href":"/status-reasons"},{"title":"Deploying through git host outages","href":"/git-host-outages"},{"title":"Deploy trace","href":"/deploy-trace"},{"title":"Deploy event timeline","href":"/deploy-event-timeline"},{"title":"Build performance","href":"/build-performance"},{"title":"Host protection","href":"/host-protection"},{"title":"Build center","href":"/build-center"},{"title":"Scheduled deploys","href":"/scheduled-deploys"},{"title":"Pull request comment commands","href":"/pr-comment-commands"},{"title":"Scheduled jobs","href":"/scheduled-jobs"},{"title":"Scheduled and background functions","href":"/scheduled-functions"},{"title":"Jobs","href":"/jobs"},{"title":"Image auto-update","href":"/image-auto-update"},{"title":"Build hooks","href":"/build-hooks"},{"title":"Sleep when idle","href":"/sleep-when-idle"},{"title":"Functions","href":"/functions"},{"title":"Canary deploys","href":"/canary-deploys"},{"title":"Split testing","href":"/split-testing"},{"title":"Deployments page","href":"/deployments-page"},{"title":"Images","href":"/images"},{"title":"Deploy previews","href":"/deploy-previews"},{"title":"Framework presets","href":"/frameworks"},{"title":"Deploy a Next.js app","sidebarTitle":"Next.js","href":"/nextjs"},{"title":"Next.js image cache volume","href":"/nextjs-image-cache"},{"title":"Next.js shared cache for multiple replicas","href":"/nextjs-shared-cache"},{"title":"Next.js skew protection, deploy side","href":"/nextjs-skew-protection"},{"title":"Deploy URLs","href":"/deploy-urls"},{"title":"Deploy links and badge","href":"/deploy-link"},{"title":"Deploy timeline","href":"/deploy-timeline"},{"title":"Deploy receipts","href":"/deploy-receipts"},{"title":"Preview environments per pull request","sidebarTitle":"Preview environments","description":"Per pull request preview environments on your own servers, with their own domain and DNS record, safe data and secret defaults, a TTL and cap, and idle sleep.","href":"/previews"},{"title":"Chat-interactive deploy approvals","sidebarTitle":"Chat approvals","href":"/chat-deploy-approvals"},{"title":"Supply chain visibility","description":"A software bill of materials per Dockerfile build, an optional vulnerability scan in a short-lived container and a gate that can block a release. Costs, limits.","href":"/supply-chain"},{"title":"Secret scanning","href":"/secret-scanning"},{"title":"Deploy status badge","href":"/deploy-status-badge"},{"title":"Dashboard screenshots","href":"/screenshots"},{"title":"Running Levelrail in Docker","href":"/docker"},{"title":"Zero-downtime deploys with Docker: readiness-gated cutover and rollback","href":"/zero-downtime-deploys"},{"title":"Rollout control","href":"/rollout-control"},{"title":"Preview environments","href":"/preview-environments"},{"title":"Deploy contexts: env and build settings per kind of deploy","href":"/deploy-contexts"}]},{"group":"Networking and multi-node","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/globe-hemisphere-west.svg","pages":[{"title":"Standalone domains","href":"/standalone-domains"},{"title":"Domain setup stepper","href":"/domains"},{"title":"Dynamic DNS","href":"/dynamic-dns"},{"title":"DNS zones and records","href":"/dns"},{"title":"DNS zones and nameserver delegation","href":"/dns-zones"},{"title":"DNS query visibility (beta)","href":"/dns-visibility"},{"title":"Egress dry run (beta)","href":"/egress-dry-run"},{"title":"Mesh DNS on the bridge gateways (beta)","href":"/mesh-dns"},{"title":"Mail DNS","tag":"Experimental","href":"/mail-dns"},{"title":"Mail server template","tag":"Experimental","href":"/mail-template"},{"title":"Mailboxes, aliases and the mail queue","tag":"Experimental","href":"/mail-mailboxes"},{"title":"Mail backup and restore","href":"/mail-backup"},{"title":"Mail storage","href":"/mail-storage"},{"title":"Diagnose a domain","href":"/domain-diagnosis"},{"title":"Domain traffic controls","href":"/domain-traffic-controls"},{"title":"Ingress abuse defense","href":"/abuse-defense"},{"title":"CDN and caching","href":"/cdn-and-caching"},{"title":"Forms","tag":"Beta","href":"/forms"},{"title":"Firewall","href":"/firewall"},{"title":"Verifying real ACME issuance against a live domain","href":"/acme-verification-runbook"},{"title":"Multi-node: adding and managing nodes","tag":"Beta","href":"/multi-node"},{"title":"Server patching","href":"/server-patching"},{"title":"Add a node anywhere","tag":"Beta","sidebarTitle":"Add a node anywhere","href":"/add-node-anywhere"},{"title":"Add a server over SSH","tag":"Beta","sidebarTitle":"Add a server over SSH","href":"/add-node-over-ssh"},{"title":"Run Levelrail on home hardware","sidebarTitle":"Home hardware","href":"/home-hardware"},{"title":"Resource-aware placement","tag":"Beta","href":"/resource-aware-placement"},{"title":"Node scheduling: taints, tolerations, affinity and score mode","tag":"Beta","href":"/node-scheduling"},{"title":"Autoscaling","tag":"Beta","href":"/autoscaling"},{"title":"Node provisioning","href":"/node-provisioning"},{"title":"Multi-cloud provisioning quickstart","href":"/multi-cloud-provisioning"},{"title":"Network topology view","href":"/network-topology"},{"title":"Private app tunnel","href":"/app-tunnel"},{"title":"Project topology graph","href":"/service-topology-graph"},{"title":"Canvas","href":"/canvas"},{"title":"Build node routing","href":"/build-node-routing"}]},{"group":"Databases and storage","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/database.svg","pages":[{"title":"Managing databases","href":"/managing-databases"},{"title":"Managed databases from the command line","sidebarTitle":"Managed databases","href":"/managed-databases"},{"title":"Postgres connection pooler","href":"/postgres-pooler"},{"title":"Database upgrades","href":"/database-upgrades"},{"title":"Database version catalog","href":"/database-version-catalog"},{"title":"External databases","href":"/external-databases"},{"title":"Connecting apps to databases","href":"/connecting-apps-to-databases"},{"title":"Backup targets, registry credentials, and app volume backups","sidebarTitle":"Backups and storage","href":"/backups-and-storage"},{"title":"Backup copies","href":"/backup-copies"},{"title":"Volume files","href":"/volume-files"},{"title":"Prove your backups work","href":"/prove-your-backups-work"},{"title":"Object storage","href":"/object-storage"},{"title":"Network shares","href":"/network-shares"},{"title":"Log explorer","href":"/log-explorer"},{"title":"Custom dashboards","href":"/custom-dashboards"},{"title":"Tracing","href":"/tracing"},{"title":"OTLP logs and metrics ingest","href":"/otlp-ingest"},{"title":"Error tracking","href":"/error-tracking"},{"title":"Loki-compatible log API","href":"/loki-api"},{"title":"Log pipelines","href":"/log-pipelines"},{"title":"Log volume budgets","href":"/log-budgets"},{"title":"Data export","href":"/data-export"},{"title":"Traffic export","href":"/traffic-export"},{"title":"Audit event schema","href":"/audit-event-schema"},{"title":"Audit log","href":"/audit-log"},{"title":"Control plane backup and restore","sidebarTitle":"Control plane backup","href":"/control-plane-backup"},{"title":"Whole-server recovery","href":"/whole-server-recovery"},{"title":"Archives","href":"/archives"},{"title":"Disaster recovery","href":"/disaster-recovery"},{"title":"Control plane recovery","href":"/control-plane-recovery"},{"title":"Upgrade safely","href":"/upgrade-safely"},{"title":"Database access and network","href":"/database-access"},{"title":"Private networks and allow rules","href":"/private-networks"},{"title":"Database explorer and fleet overview","href":"/database-explorer"},{"title":"Database viewer","href":"/database-viewer"}]},{"group":"CI/CD and automation","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/git-branch.svg","pages":[{"title":"Deploying from GitHub Actions","href":"/github-actions"},{"title":"Use any CI","href":"/use-any-ci"},{"title":"Pipelines","href":"/pipelines"},{"title":"Pipelines: OIDC federation","href":"/pipelines-oidc"},{"title":"Git integrations","href":"/git-integrations"},{"title":"Azure DevOps","href":"/azure-devops"},{"title":"Git reliability","href":"/git-reliability"},{"title":"Wait for CI before deploying","href":"/ci-gate"},{"title":"Deploy with git push","href":"/git-push-deploy"},{"title":"Import a repository","sidebarTitle":"Import a repo","href":"/import-a-repo"},{"title":"Monorepos","href":"/monorepos"}]},{"group":"Security and access","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/shield-check.svg","pages":[{"title":"Sign-in engine","href":"/auth-engine"},{"title":"Host firewall","href":"/host-firewall"},{"title":"Exposure audit","href":"/exposure-audit"},{"title":"Security center","href":"/security-center"},{"title":"Compliance evidence","href":"/compliance-evidence"},{"title":"Emergency access","href":"/emergency-access"},{"title":"Master key rotation","href":"/master-key-rotation"},{"title":"Secret rotation policies","href":"/secret-rotation"},{"title":"Vault and OpenBao secret references","href":"/vault-secret-references"},{"title":"Your account","href":"/account"},{"title":"Access control","href":"/access-control"},{"title":"Labels and namespaces","href":"/labels"},{"title":"Teams and roles","href":"/teams-and-roles"},{"title":"Team and project quotas","href":"/team-and-project-quotas"},{"title":"Environments","href":"/environments"},{"title":"Promotions and release notes","href":"/promotions-and-releases"},{"title":"Identity and access: users, roles, and IAM policies","href":"/identity-and-access"},{"title":"SAML single sign-on","href":"/sso-saml"},{"title":"OAuth and OIDC single sign-on","href":"/sso-oidc"},{"title":"SCIM provisioning","href":"/scim"},{"title":"Session policy","href":"/session-policy"},{"title":"Projects, organizations, and environments","href":"/projects-and-organizations"}]},{"group":"Scale and operations","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/chart-line-up.svg","pages":[{"title":"Managing apps at scale","href":"/managing-apps-at-scale"},{"title":"Tags","href":"/tags"},{"title":"Resource console","href":"/resource-console"},{"title":"Command palette","href":"/command-palette"},{"title":"Keyboard shortcuts","href":"/keyboard"},{"title":"Cost estimate","href":"/cost-estimate"},{"title":"Usage and cost","href":"/usage-and-cost"},{"title":"Cost explorer and budgets","href":"/cost-explorer"},{"title":"Spend caps","href":"/spend-caps"},{"title":"Integrations","href":"/integrations"},{"title":"Cloud integrations","href":"/cloud-integrations"},{"title":"Rolling back the control plane","href":"/rollback"},{"title":"Pre-deploy database snapshots","href":"/predeploy-snapshot"},{"title":"Resilience: what survives a control plane crash","href":"/resilience"},{"title":"Resilience, in short","href":"/resilience-summary"},{"title":"Host pressure guard (beta)","href":"/host-pressure"},{"title":"Chaos test coverage","href":"/chaos-coverage"},{"title":"Observability: metrics, logs, and alerts","href":"/observability"},{"title":"Traffic observability: rate, errors and duration","href":"/traffic-observability"},{"title":"Prometheus scrape endpoint","href":"/prometheus-scrape"},{"title":"Web vitals","href":"/web-vitals"},{"title":"Public status page","href":"/status-page"},{"title":"Monitors","href":"/monitors"},{"title":"External monitoring","href":"/external-monitoring"},{"title":"Scheduled maintenance","href":"/scheduled-maintenance"},{"title":"Deploy policies","href":"/deploy-policies"},{"title":"What's new panel","href":"/whats-new-panel"}]},{"group":"AI and agents","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/sparkle.svg","pages":[{"title":"Working with AI agents","href":"/agents"},{"title":"AI control","href":"/ai-control"}]},{"group":"Templates and catalog","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/squares-four.svg","pages":[{"title":"Service template catalog","tag":"Beta","href":"/templates-and-registry"},{"title":"Private registries","href":"/private-registries"},{"title":"Template upgrades","href":"/template-upgrades"},{"title":"Template catalog","href":"/template-catalog"},{"title":"Deploy button","href":"/deploy-button"},{"title":"Template status","href":"/templates-status"},{"title":"Catalog index","href":"/catalog-index"},{"title":"Add a template","href":"/add-a-template"},{"title":"Arm64 compatibility","href":"/arm-compatibility"},{"title":"Starter kit templates","href":"/templates"}]},{"group":"Migrate","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/arrows-left-right.svg","pages":[{"title":"Migrate to Levelrail","sidebarTitle":"Migration overview","href":"/migrate-to-levelrail"},{"title":"Migration wizard","sidebarTitle":"Migration wizard","href":"/migration-wizard"},{"title":"Migrate from Coolify","sidebarTitle":"From Coolify","href":"/migrate-from-coolify"},{"title":"Coolify exit gap report","sidebarTitle":"Coolify exit gaps","href":"/coolify-exit-gap-report"},{"title":"Move a Coolify one-click service to a Compose app","sidebarTitle":"Service to Compose","href":"/coolify-service-to-compose"},{"title":"Migrate from Dokploy","sidebarTitle":"From Dokploy","href":"/migrate-from-dokploy"},{"title":"Migrate from CapRover","sidebarTitle":"From CapRover","href":"/migrate-from-caprover"},{"title":"Migrate from Dokku","sidebarTitle":"From Dokku","href":"/migrate-from-dokku"},{"title":"Migrate from Docker Compose","sidebarTitle":"From Docker Compose","href":"/migrate-from-docker-compose"},{"title":"Import Kubernetes manifests","href":"/import-kubernetes"},{"title":"Connect and deploy to an existing Kubernetes cluster","sidebarTitle":"Kubernetes clusters","href":"/kubernetes-clusters"},{"title":"Migration reference","sidebarTitle":"Reference","href":"/migration-reference"},{"title":"Migrating from Coolify, Dokploy, or CapRover","sidebarTitle":"Moved: migration guides","href":"/migrating-from-coolify-dokploy-and-caprover"},{"title":"Migration agent threat model","sidebarTitle":"Migration agent threat model","href":"/migration-agent-threat-model"},{"title":"Migrate on the same server","href":"/migrate-same-server"},{"title":"Move a domain with no downtime","href":"/move-a-domain-with-no-downtime"},{"title":"Migrate over SSH","sidebarTitle":"Migrate over SSH","href":"/migrate-over-ssh"},{"title":"Migrate a project from Vercel","href":"/migrate-from-vercel"},{"title":"Migrating a Next.js app from Vercel","href":"/migrating-from-vercel"},{"title":"Migrating a static site from Netlify","href":"/migrating-from-netlify"},{"title":"Migrating a service from Cloud Run","href":"/migrating-from-cloud-run"}]},{"group":"Infrastructure as code","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/flask.svg","pages":[{"title":"IaC quickstart","tag":"Experimental","href":"/iac/index"},{"title":"IaC templates","tag":"Experimental","href":"/iac/templates"},{"title":"How IaC apply works","tag":"Experimental","href":"/iac/how-it-works"},{"title":"IaC in CI","tag":"Experimental","href":"/iac/ci"},{"title":"GitHub Action for IaC","tag":"Experimental","href":"/iac/github-action"},{"title":"Git sync for stacks","tag":"Experimental","href":"/iac/git-sync"},{"title":"Connect a cloud account","tag":"Experimental","href":"/iac/cloud-connect"},{"title":"IaC resource kinds","tag":"Experimental","href":"/iac/resources"},{"title":"Cron jobs and alert rules in files","sidebarTitle":"Cron and alert files","href":"/iac/cron-and-alerts"},{"title":"Import from a deploy.yml or a Portainer stack","sidebarTitle":"Importers","href":"/iac/importers"},{"title":"Compose projects as code","tag":"Beta","href":"/iac/compose"},{"title":"Reference","href":"/iac/reference"},{"title":"Errors","href":"/iac/errors"},{"title":"Platform as code","tag":"Experimental","href":"/platform-as-code"},{"title":"Stacks and GitOps","tag":"Experimental","href":"/stacks"}]},{"group":"Beta and experimental","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/flask.svg","pages":[{"title":"AI assistant integration: levelrail-mcp","tag":"Beta","href":"/ai-assistant"},{"title":"MCP tools, token budget and write mode","tag":"Beta","href":"/mcp"},{"title":"Connect an AI assistant safely","href":"/mcp-safe-setup"},{"title":"MCP recipes","tag":"Beta","href":"/mcp-recipes"},{"title":"In-app AI assistant chat","tag":"Experimental","href":"/ai-assistant-chat"},{"title":"AI models","tag":"Experimental","href":"/ai-models"},{"title":"Load balancing across replicas","tag":"Experimental","href":"/load-balancing"},{"title":"Leave anytime","sidebarTitle":"Leave anytime","href":"/leave-anytime"},{"title":"Resource advisor (beta)","tag":"Beta","href":"/resource-advisor"},{"title":"Cloud connections (preview)","href":"/cloud-connections"},{"title":"CLI console (beta)","tag":"Beta","href":"/cli-console"},{"title":"Feature flags","href":"/feature-flags"},{"title":"Log archive","tag":"Beta","href":"/log-archive"},{"title":"Automatic cleanup","tag":"Beta","href":"/janitor"},{"title":"Cleanup center","tag":"Beta","href":"/cleanup-center"},{"title":"Unified search","tag":"Beta","href":"/search"}]}]},{"tab":"Reference","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/code.svg","pages":[{"title":"Reference","href":"/app-spec-reference"}]},{"tab":"Concepts","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/lightbulb.svg","pages":[{"title":"Concepts","href":"/product-tour"}]},{"tab":"Self-host gallery","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/squares-four.svg","pages":[{"title":"Self-host gallery","href":"/self-host"}]},{"tab":"Appendix","icon":"https://mintlify.s3.us-west-1.amazonaws.com/levelrail/assets/icons/books.svg","pages":[{"title":"Appendix","href":"/roadmap"}]}]},"basePath":"","title":"Chat-interactive deploy approvals - Levelrail","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}