Poolside Reference Architectures

Your data. Your models. Your future — inside your own cloud boundary.

Poolside is a secure, enterprise-grade AI platform for software engineering, designed to run entirely within your infrastructure. This repository publishes opinionated reference infrastructure-as-code for deploying Poolside in your own cloud, a transparent, production-grade happy path for deploying the Poolside platform and models into your cloud account.

• Learn about the platform: poolside.ai
• Product documentation: docs.poolside.ai

Get the deployment bundle

These reference architectures include the public infrastructure and deployment patterns for running Poolside in your environment.

To deploy it, you will also need the Poolside deployment bundle, which includes:

• private Helm charts
• OCI images
• versioned release artifacts
• deployment guidance and support materials

Request access to the Poolside deployment bundle: Contact Sales

This public repository is intended to show the reference architectures, infrastructure patterns, and deployment workflow. The Poolside software artifacts themselves are distributed separately to approved customers and evaluators.

Reference architectures

Cloud	Status	Path
AWS	EKS, single terraform apply	aws/

What's in aws/

A complete deployment of the Poolside platform on Amazon EKS, provisioned in a single Terraform pass:

• Composable Terraform modules for network, EKS, data stores, IAM, KMS, ingress, GPU operator, secrets sync, Cognito, and more.
• Two runnable example roots — platform-only (no GPUs; bring your own inference) and full (platform + local GPU inference).
• Quickstarts and an architecture walkthrough under aws/docs/.

Start at aws/README.md.

Prerequisites

• The Poolside deployment bundle — contact Poolside sales to obtain access.
• An AWS account you control, with the IAM permissions required by the example of your choice (documented per-example).
• terraform (>= 1.5.7), helm, skopeo, and the aws CLI installed locally.

Layout

reference_architectures/
├── docs/            # cross-cutting documentation
└── aws/             # AWS reference architecture
    ├── docs/        # AWS-specific guides and quickstarts
    ├── examples/    # end-to-end Terraform roots
    └── modules/     # composable Terraform modules

Support

• Deployment questions on this repo: open a GitHub issue.
• Product, licensing, and access to Poolside artifacts: contact Poolside sales.