Installation

UnderOcean deploys as a self-contained set of services that run entirely on your own infrastructure — there is no dependency on a third-party managed cloud.

Prerequisites

• A container orchestration environment (e.g. Docker Compose)
• Access to the UnderOcean deployment package
• At least one AI provider API key (OpenAI, Anthropic, etc.) — or a self-hosted model endpoint if you prefer not to use a hosted provider

1. Configure environment variables

Copy the provided environment template and fill in the required secrets: database credentials, token signing keys, the secret-encryption key used to protect stored provider credentials, and object storage credentials.

None of these have safe defaults — the platform will refuse to start with placeholder values.

2. Start the platform

Bring up the full stack. This provisions the database, cache, vector store, API, and frontend services.

3. Run database migrations

Apply the latest schema migrations before first use.

4. Open the app

Once running, the frontend and API become available at the addresses configured for your environment.

Continue to Quick Start to create your first organization, connect a provider, and run an agent.