Deploy with an agent
Copy agent prompt
Before you start
Connect your AWS account and choose a project. Review the upstream deployment instructions for the release you plan to pin. See Langfuse environment variables.Data dependencies
PostgreSQL, ClickHouse, compatible Redis or Valkey, and private S3-compatible object storage. See SQL databases for private writer access and connection details.Deployment order
- Create PostgreSQL in the Spring Winter project and wait for its writer. Provision ClickHouse, the cache and object storage before starting either Langfuse process. Verify private access and the cache’s supported topology.
- Set
DATABASE_URLandCLICKHOUSE_URL. Give the migration process a reachableCLICKHOUSE_MIGRATION_URLand the required grants. Configure the cache connection andLANGFUSE_S3_EVENT_UPLOAD_*settings using the pinned release’s configuration. - Deploy matching Langfuse web and worker images. Set shared secrets consistently and set
NEXTAUTH_URLto the HTTPS web URL. Use a supported Spring Winter worker source, such as a GitHub Dockerfile wrapping the pinned upstream worker image, or run the worker on the chosen external host. - Run the release’s PostgreSQL and ClickHouse migration sequence. If the web image runs migrations on startup, wait for its readiness. Start the worker after migrations succeed and send traffic once both processes are healthy.