Skip to main content
This page describes the platform features that apply only to self-hosted deployments.

​
Custom PostgreSQL

A custom PostgreSQL instance can be used instead of the one automatically created by the control plane. Specify the POSTGRES_URI_CUSTOM environment variable to use a custom PostgreSQL instance. Multiple deployments can share the same PostgreSQL instance. For example, for Deployment A, POSTGRES_URI_CUSTOM can be set to postgres://<user>:<password>@/<database_name_1>?host=<hostname_1> and for Deployment B, POSTGRES_URI_CUSTOM can be set to postgres://<user>:<password>@/<database_name_2>?host=<hostname_1>. <database_name_1> and <database_name_2> are different databases within the same instance, but <hostname_1> is shared. The same database cannot be used for separate deployments.

​
Custom Redis

A custom Redis instance can be used instead of the one automatically created by the control plane. Specify the REDIS_URI_CUSTOM environment variable to use a custom Redis instance. Multiple deployments can share the same Redis instance. For example, for Deployment A, REDIS_URI_CUSTOM can be set to redis://<hostname_1>:<port>/1 and for Deployment B, REDIS_URI_CUSTOM can be set to redis://<hostname_1>:<port>/2. 1 and 2 are different database numbers within the same instance, but <hostname_1> is shared. The same database number cannot be used for separate deployments.

​
Listeners

A listener is an instance of a listener application. A listener contains metadata about the application (such as its version) and metadata about the compute infrastructure where it can deploy to (such as Kubernetes namespaces). The listener data model only applies to self-hosted deployments. The control plane and listener coordinate to provision and reconcile deployments running on your own infrastructure.

​
Resource customization

Resources for self-hosted deployments can be fully customized. Unlike Cloud, which exposes fixed Development and Production deployment types, self-hosted deployments size CPU, memory, replicas, and storage according to your infrastructure configuration. See Configure Agent Server for scale for tuning guidance.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.
Edit this page on GitHub or file an issue.