Pair AgentKit with an existing Coolify instance, or have Oracle install Coolify on a fresh server.
Draft: these steps await verification against the current release of AgentKit.
Outcome: AgentKit holds its own Coolify connection, the platform where it places your agents’ server nodes.AgentKit holds one Coolify connection of its own. It belongs to the app, not to any agent, and no agent’s vault holds its token. There are two ways to get it: connect an instance you already have, or create one on a fresh server.
What you need
To connect: an existing Coolify instance’s address and an API token for it.
To create: a fresh server your Mac reaches as root over SSH, and its IP address.
Steps in the app
Connect an existing instance
Create an instance
1
Open Settings > Coolify
Open Settings (⌘,) and go to Coolify.
2
Enter the address and token
Type the instance’s address and paste its API token. AgentKit validates the token against the instance and keeps it in a file of its own, readable only by you, that leaves the Mac only for that Coolify.
1
Open Settings > Coolify and choose Create instance
Type the IP address of the server.
2
Press Create
Your press is the confirmation for everything the install needs, so it runs to its end without further questions. AgentKit starts an Oracle session that installs Coolify on the server by the Coolify capability’s bootstrap procedure. Oracle works around what a script would not foresee, and says what you must do when it cannot finish.
3
Answer the database question, if asked
The install also sets up a Postgres on the new server, but never switches your Mac’s database on its own:
With a database already configured, Oracle leaves it and says the new server’s Postgres can take over later; your data does not move by itself.
With none configured, Oracle asks you to choose between the new server’s Postgres and Supabase. The server’s Postgres needs no outside account, but lives and fails with that server, and you back it up. Supabase does not depend on the server, and its free plan has its own limits.
4
Wait for the pairing
The session ends with the new instance paired with your Mac, and it becomes AgentKit’s Coolify when none was set.
Steps by command line
Oracle follows the Coolify capability’s own bootstrap procedure, which you can read:
coolify guide bootstrapcoolify help
Check it worked
Settings > Coolify shows the connected instance.
An agent’s Add Node offers the servers of this Coolify, each with its free memory. See Add a server node.
Common failures
What you see
Why, and what to do
The token is refused
It is wrong or lacks rights on that instance. Create a new API token in Coolify.
Oracle cannot reach the server
Your Mac must reach it as root over SSH. Check ssh root@<server-ip> works from a terminal.
Oracle stops and asks you to do something
A step needs you, such as a DNS or firewall change. Do it and tell Oracle in the session.
Your agents still use the old database after Create
That is by design: Oracle never switches the database on its own.
TODO: the exact labels of the Connect form’s fields and buttons, and whether several Coolify connections can be held, await verification.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Agenium","description":"AgentKit by Agenium is a native macOS app that gives one window over the agent work on your Mac: Claude and Codex sessions, your agents, the capabilities they work with, their tasks, the Inbox, rooms and teams.","colors":{"primary":"#E0702E","light":"#F39A5C","dark":"#B8561C"},"logo":{"light":"https://mintcdn.com/agenium/Z_pl6sP7HNYbDDEN/logo/light.svg?fit=max\u0026auto=format\u0026n=Z_pl6sP7HNYbDDEN\u0026q=85\u0026s=74a1fc9986a65d0e1e893ff6815363fe","dark":"https://mintcdn.com/agenium/Z_pl6sP7HNYbDDEN/logo/dark.svg?fit=max\u0026auto=format\u0026n=Z_pl6sP7HNYbDDEN\u0026q=85\u0026s=1bbfe61db85fe6eccc345bf4c9f96a1b","href":"/introduction"},"favicon":"https://mintcdn.com/agenium/Z_pl6sP7HNYbDDEN/favicon.svg?fit=max\u0026auto=format\u0026n=Z_pl6sP7HNYbDDEN\u0026q=85\u0026s=68869029de8caa78cce2221e20f7fe94","appearance":{"default":"system"},"navbar":{"primary":{"type":"button","label":"Download for Mac","href":"https://download.agenium.dev"}},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"agenium","hasAudioNarration":false,"actualSubdomain":"agenium","customDomains":["docs.agenium.io"],"gitSource":{"type":"github","owner":"agenium-dev","repo":"agenium-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6b01a52ba08f8245a92ee9f0"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b01c61ed4209aff3f6bc778","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Capabilities","count":45},{"language":"default","tag":"Documentation","count":19},{"language":"default","tag":"System capabilities","count":11},{"language":"default","tag":"App","count":10},{"language":"default","tag":"Messaging and rooms","count":7},{"language":"default","tag":"Work trackers and knowledge","count":6},{"language":"default","tag":"Mail and calendars","count":6},{"language":"default","tag":"Recipes","count":6},{"language":"default","tag":"Infrastructure","count":5},{"language":"default","tag":"Finance and travel","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"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":"recipes/connect-coolify-and-create-instance","slug":"/recipes/connect-coolify-and-create-instance","pageMetadata":{"title":"Connect Coolify and create an instance","sidebarTitle":"Connect Coolify","description":"Pair AgentKit with an existing Coolify instance, or have Oracle install Coolify on a fresh server.","icon":"server","status":"draft-unverified","href":"/recipes/connect-coolify-and-create-instance"},"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: \"Pair AgentKit with an existing Coolify instance, or have Oracle install Coolify on a fresh server.\"\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`,ol:`ol`,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,Mermaid,Note,Step,Steps,Tab,Table,Tabs}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,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);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsx(_components.p,{children:`Draft: these steps await verification against the current release of AgentKit.`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Outcome:`}),` AgentKit holds its own Coolify connection, the platform where it places your agents’ server nodes.`]}),`\n`,_jsx(_components.p,{children:`AgentKit holds one Coolify connection of its own. It belongs to the app, not to any agent, and no agent’s vault holds its token. There are two ways to get it: connect an instance you already have, or create one on a fresh server.`}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n subgraph a[\"Connect\"]\n addr[\"Address + API token\"] --> ak1[\"AgentKit validates\u003cbr/>and keeps it\"]\n end\n subgraph b[\"Create instance\"]\n ip[\"Server IP\u003cbr/>(root over SSH)\"] --> oracle[\"Oracle session\"]\n oracle -- \"installs\" --> coolify[\"Coolify + Postgres\u003cbr/>on the server\"]\n coolify -- \"paired\" --> ak2[\"AgentKit\"]\n end`}),`\n`,_jsx(Heading,{level:`2`,id:`what-you-need`,children:`What you need`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`To connect`}),`: an existing Coolify instance’s address and an API token for it.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`To create`}),`: a fresh server your Mac reaches as root over SSH, and its IP address.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`steps-in-the-app`,children:`Steps in the app`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Connect an existing instance`,id:`connect-an-existing-instance`,children:_jsxs(Steps,{children:[_jsx(Step,{title:`Open Settings > Coolify`,children:_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Settings`}),` (⌘,) and go to `,_jsx(_components.strong,{children:`Coolify`}),`.`]})}),_jsx(Step,{title:`Enter the address and token`,children:_jsx(_components.p,{children:`Type the instance’s address and paste its API token. AgentKit validates the token against the instance and keeps it in a file of its own, readable only by you, that leaves the Mac only for that Coolify.`})})]})}),_jsx(Tab,{title:`Create an instance`,id:`create-an-instance`,children:_jsxs(Steps,{children:[_jsx(Step,{title:`Open Settings > Coolify and choose Create instance`,children:_jsx(_components.p,{children:`Type the IP address of the server.`})}),_jsx(Step,{title:`Press Create`,children:_jsxs(_components.p,{children:[`Your press is the confirmation for everything the install needs, so it runs to its end without further questions. AgentKit starts an `,_jsx(_components.a,{href:`/app/oracle`,children:`Oracle`}),` session that installs Coolify on the server by the Coolify capability’s bootstrap procedure. Oracle works around what a script would not foresee, and says what you must do when it cannot finish.`]})}),_jsxs(Step,{title:`Answer the database question, if asked`,children:[_jsx(_components.p,{children:`The install also sets up a Postgres on the new server, but never switches your Mac’s database on its own:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`With a database already configured, Oracle leaves it and says the new server’s Postgres can take over later; your data does not move by itself.`}),`\n`,_jsx(_components.li,{children:`With none configured, Oracle asks you to choose between the new server’s Postgres and Supabase. The server’s Postgres needs no outside account, but lives and fails with that server, and you back it up. Supabase does not depend on the server, and its free plan has its own limits.`}),`\n`]})]}),_jsx(Step,{title:`Wait for the pairing`,children:_jsx(_components.p,{children:`The session ends with the new instance paired with your Mac, and it becomes AgentKit’s Coolify when none was set.`})})]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`steps-by-command-line`,children:`Steps by command line`}),`\n`,_jsx(_components.p,{children:`Oracle follows the Coolify capability’s own bootstrap procedure, which you can read:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,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:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`coolify`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` guide`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` bootstrap`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`coolify`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` help`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`check-it-worked`,children:`Check it worked`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Settings > Coolify`}),` shows the connected instance.`]}),`\n`,_jsxs(_components.li,{children:[`An agent’s `,_jsx(_components.strong,{children:`Add Node`}),` offers the servers of this Coolify, each with its free memory. See `,_jsx(_components.a,{href:`/recipes/add-a-server-node-and-move-a-service`,children:`Add a server node`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`common-failures`,children:`Common failures`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`What you see`}),_jsx(_components.th,{children:`Why, and what to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The token is refused`}),_jsx(_components.td,{children:`It is wrong or lacks rights on that instance. Create a new API token in Coolify.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Oracle cannot reach the server`}),_jsxs(_components.td,{children:[`Your Mac must reach it as root over SSH. Check `,_jsx(_components.code,{children:`ssh root@\u003cserver-ip>`}),` works from a terminal.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Oracle stops and asks you to do something`}),_jsx(_components.td,{children:`A step needs you, such as a DNS or firewall change. Do it and tell Oracle in the session.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Your agents still use the old database after Create`}),_jsx(_components.td,{children:`That is by design: Oracle never switches the database on its own.`})]})]})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`TODO: the exact labels of the Connect form’s fields and buttons, and whether several Coolify connections can be held, await verification.`})}),`\n`,_jsx(Heading,{level:`2`,id:`related`,children:`Related`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/app/settings#coolify`,children:`Settings > Coolify`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/capabilities/coolify`,children:`Coolify capability`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/app/oracle`,children:`Oracle`})}),`\n`]})]})}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":"Connect Coolify and create an instance","sidebarTitle":"Connect Coolify","description":"Pair AgentKit with an existing Coolify instance, or have Oracle install Coolify on a fresh server.","icon":"server","status":"draft-unverified","href":"/recipes/connect-coolify-and-create-instance"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What you need","slug":"what-you-need","depth":2,"children":[]},{"title":"Steps in the app","slug":"steps-in-the-app","depth":2,"children":[]},{"title":"Steps by command line","slug":"steps-by-command-line","depth":2,"children":[]},{"title":"Check it worked","slug":"check-it-worked","depth":2,"children":[]},{"title":"Common failures","slug":"common-failures","depth":2,"children":[]},{"title":"Related","slug":"related","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"agenium","siteName":"Agenium","title":"Connect Coolify and create an instance - Agenium","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-21T14:06:26.118Z","originalFileLocation":"recipes/connect-coolify-and-create-instance.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=\"Pair AgentKit with an existing Coolify instance, or have Oracle install Coolify on a fresh server.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Agenium\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/agenium/mmVAp0D3hc5FSmtJ/_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/agenium/mmVAp0D3hc5FSmtJ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/agenium/mmVAp0D3hc5FSmtJ/_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/agenium/mmVAp0D3hc5FSmtJ/_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/agenium/mmVAp0D3hc5FSmtJ/_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/agenium/mmVAp0D3hc5FSmtJ/_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/agenium/mmVAp0D3hc5FSmtJ/_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/agenium/mmVAp0D3hc5FSmtJ/_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/agenium/mmVAp0D3hc5FSmtJ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect Coolify and create an instance - Agenium\">\u003cmeta data-mint-head property=\"og:description\" content=\"Pair AgentKit with an existing Coolify instance, or have Oracle install Coolify on a fresh server.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Agenium\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.agenium.io/recipes/connect-coolify-and-create-instance\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://agenium.mintlify.site/_mintlify/api/og/v2?division=Recipes\u0026amp;title=Connect+Coolify+and+create+an+instance\u0026amp;description=Pair+AgentKit+with+an+existing+Coolify+instance%2C+or+have+Oracle+install+Coolify+on+a+fresh+server.\u0026amp;theme=366566f9638504603ae3d10b\u0026amp;signature=3cfd4419f145988196152744bc0cbd59703bf642d0d296a897b2db438e598456\">\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=\"Connect Coolify and create an instance - Agenium\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Pair AgentKit with an existing Coolify instance, or have Oracle install Coolify on a fresh server.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://agenium.mintlify.site/_mintlify/api/og/v2?division=Recipes\u0026amp;title=Connect+Coolify+and+create+an+instance\u0026amp;description=Pair+AgentKit+with+an+existing+Coolify+instance%2C+or+have+Oracle+install+Coolify+on+a+fresh+server.\u0026amp;theme=366566f9638504603ae3d10b\u0026amp;signature=3cfd4419f145988196152744bc0cbd59703bf642d0d296a897b2db438e598456\">\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/agenium/mmVAp0D3hc5FSmtJ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Agenium\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E0702E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.agenium.io/recipes/connect-coolify-and-create-instance\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/recipes/connect-coolify-and-create-instance.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.agenium.io/#organization\",\"name\":\"Agenium\",\"url\":\"https://docs.agenium.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/agenium/Z_pl6sP7HNYbDDEN/logo/light.svg?fit=max\u0026auto=format\u0026n=Z_pl6sP7HNYbDDEN\u0026q=85\u0026s=74a1fc9986a65d0e1e893ff6815363fe\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.agenium.io#website\",\"name\":\"Agenium\",\"url\":\"https://docs.agenium.io\",\"publisher\":{\"@id\":\"https://docs.agenium.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.agenium.io/recipes/connect-coolify-and-create-instance#webpage\",\"url\":\"https://docs.agenium.io/recipes/connect-coolify-and-create-instance\",\"name\":\"Connect Coolify and create an instance\",\"description\":\"Pair AgentKit with an existing Coolify instance, or have Oracle install Coolify on a fresh server.\",\"dateModified\":\"2026-11-21T14:06:26.118Z\",\"isPartOf\":{\"@id\":\"https://docs.agenium.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.agenium.io/recipes/connect-coolify-and-create-instance#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.agenium.io/recipes/connect-coolify-and-create-instance#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Recipes\",\"item\":\"https://docs.agenium.io/recipes\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect Coolify and create an instance\",\"item\":\"https://docs.agenium.io/recipes/connect-coolify-and-create-instance\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.agenium.io/recipes/connect-coolify-and-create-instance#article\",\"headline\":\"Connect Coolify and create an instance\",\"name\":\"Connect Coolify and create an instance\",\"description\":\"Pair AgentKit with an existing Coolify instance, or have Oracle install Coolify on a fresh server.\",\"url\":\"https://docs.agenium.io/recipes/connect-coolify-and-create-instance\",\"mainEntityOfPage\":{\"@id\":\"https://docs.agenium.io/recipes/connect-coolify-and-create-instance#webpage\"},\"dateModified\":\"2026-11-21T14:06:26.118Z\",\"publisher\":{\"@id\":\"https://docs.agenium.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.agenium.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Agenium\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Agenium\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/recipes/connect-coolify-and-create-instance.md","siteName":"Agenium","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","groups":[{"group":"Get started","pages":[{"title":"Introduction","icon":"house","href":"/introduction"},{"title":"Install AgentKit","icon":"download","href":"/install"},{"title":"Your first agent","icon":"bot","href":"/first-agent"}]},{"group":"App","pages":[{"title":"Sessions","icon":"messages-square","href":"/app/sessions"},{"title":"Agents","icon":"bot","href":"/app/agents"},{"title":"Capabilities","icon":"blocks","href":"/app/capabilities"},{"title":"Tasks","icon":"list-checks","href":"/app/tasks"},{"title":"Inbox","icon":"inbox","href":"/app/inbox"},{"title":"Rooms","icon":"message-square-text","href":"/app/rooms"},{"title":"Teams","icon":"users","href":"/app/teams"},{"title":"Oracle","icon":"sparkles","href":"/app/oracle"},{"title":"Settings","icon":"settings","href":"/app/settings"},{"title":"Updates and releases","icon":"refresh-cw","href":"/app/updates-and-releases"}]},{"group":"Recipes","pages":[{"title":"Recipes","icon":"chef-hat","href":"/recipes/index"},{"title":"Connect a Supabase database","sidebarTitle":"Connect Supabase","description":"Give AgentKit its shared database through Supabase's own sign-in, with no credentials to copy.","icon":"database","href":"/recipes/connect-supabase-database"},{"title":"Connect Coolify and create an instance","sidebarTitle":"Connect Coolify","icon":"server","href":"/recipes/connect-coolify-and-create-instance"},{"title":"Connect a Telegram account","sidebarTitle":"Connect Telegram","description":"Set up your own Telegram app once per Mac, link a Telegram account by QR code, and grant it to an agent.","icon":"send","href":"/recipes/connect-telegram-account"},{"title":"Add a server node and move a service","sidebarTitle":"Add a server node","icon":"server-cog","href":"/recipes/add-a-server-node-and-move-a-service"},{"title":"Talk to an agent by voice","sidebarTitle":"Talk by voice","icon":"mic","href":"/recipes/talk-to-an-agent-by-voice"}]}]},{"tab":"Capabilities","icon":"blocks","pages":[{"title":"Capabilities","href":"/capabilities/overview"}]}]},"basePath":"","title":"Connect Coolify and create an instance - Agenium","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}