Skip to main content
The one-command bootstrap installer currently targets AWS. To run the agent anywhere Docker runs (your laptop or a self-managed host), start it from the published container image. This is the interim manual path until Docker lands in the bootstrap installer.

​
Prerequisites

  • The formae CLI on your local machine (see the Quick start).
  • Docker installed and running.
The formae agent is published as a container image:
Supported architectures: linux/amd64 and linux/arm64.

​
Run with Docker

The agent API is available on port 49684.

​
Run a specific version

​
Custom configuration

Mount a custom config file and point the agent at it with --config:
The config file is Pkl and amends the bundled schema. For example, to point the agent at PostgreSQL instead of the default SQLite:
See the Configuration reference for all available options.

​
Connect your CLI

The CLI runs on your machine, evaluates Pkl locally, and sends the result to the agent API. No forma files need to be loaded into the container. When you run the container locally with -p 49684:49684, the agent is reachable at http://localhost:49684, which is exactly where the default profile already points. So a local container needs no profile setup at all:
If the agent runs on a remote host, add a profile whose cli.api.url is that host, on port 49684:
Then target it per command:

​
Next steps