Skip to main content
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

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.

Steps by command line

Oracle follows the Coolify capability’s own bootstrap procedure, which you can read:

Check it worked

  1. Settings > Coolify shows the connected instance.
  2. An agent’s Add Node offers the servers of this Coolify, each with its free memory. See Add a server node.

Common failures

TODO: the exact labels of the Connect form’s fields and buttons, and whether several Coolify connections can be held, await verification.