Skip to main content

Retool AI for self-hosted deploymentsBeta

Learn about using Retool AI with self-hosted deployments.

Self-hosted customers running Retool 3.14 or later can deploy and embed Retool AI within applications and workflows.

AI platform options

You can configure a direct connection to a supported AI platform by providing an API key. You also have the option to use a Retool-managed OpenAI connection. For production use cases, Retool recommends you provide an API key and directly connect to an AI platform.

The Retool-managed OpenAI connection is disabled by default. Contact your Retool account representative or our support team to gain access.

Disable Retool AI for your deployment

You can disable Retool AI from Settings > Beta.

Retool Vectors

Retool Vectors for self-hosted deployments is built on Retool Database. To store vector data, you must configure and enable Retool Vectors and Retool Database.

AI Actions

Version required

Your self-hosted Retool deployment must be on version 3.14 or later to use AI Actions.

To enable AI Actions on self-hosted deployments using a Retool-provided key, set the following environment variables.

For OPENAI_PROXY_API_TOKEN, contact your Retool account manager to generate a Retool-provided token. Keys provided by Retool are subject to rather aggressive rate limits and are not suitable for production use cases. If the rate limiting is an issue, then you should use your own key and set it from the Retool AI resource page.

Environment variableValue
LICENSE_KEYYour self-hosted Retool license key.
OPENAI_PROXY_HOSTSet to https://spb8yl7d3j.execute-api.us-west-2.amazonaws.com.
OPENAI_PROXY_API_TOKENContact your Retool account manager to generate a Retool-provided token.
OPENAI_SECRET_KEYSet to an empty string.

Data sharing and retention

When Retool AI is used to build or configure a query, application, or workflow (e.g., prompting Ask AI to help write queries), the input is shared with the applicable third-party LLM provider, listed in our Subprocessors page. Inputs are deleted within 30 days.

Any inputs or outputs that correspond to the categories above may continue to be used to inform product improvements. Retool does not use any inputs submitted to, or outputs generated from, Retool AI that is embedded within a deployed application or workflow (e.g., text stored in Retool Vectors). These inputs and outputs are treated as "Customer Data" in accordance with the Customer Terms of Service, Security Practices, and Data Processing Addendum.