Skip to content

Install on AWS

Install on AWS

One-touch bootstrap creates the S3 bucket, S3 Vector bucket + index, and the least-privilege runtime IAM user — then you deploy the Pollenix container with helm.

Step 1 — Provision storage and IAM

Terminal window
git clone https://github.com/adroitts/pollenix
cd pollenix/infra/marketplace
./pollenix-setup.sh <tenant-slug> us-east-1 pollenix-admin

The script is idempotent. Re-running it just verifies the existing resources and prints the runtime credentials.

What gets created:

ResourceName
Files bucketpollenix-files-<account>-<slug>
Vector bucketpollenix-vec-<account>-<slug>
Vector indexpollenix-rag (1536-dim, cosine)
Runtime IAM userpollenix-runtime-<slug>

Paste the JSON output into Pollenix → Setup → Storage → Import during the first-run wizard.

The pollenix-setup.sh output — copy this JSON into the setup wizard.
The pollenix-setup.sh output — copy this JSON into the setup wizard.

Step 2 — Provision the EKS cluster

A reference cluster manifest is provided. Fargate-only — no node groups to babysit.

Terminal window
cd ../aws/eks
AWS_PROFILE=pollenix-admin eksctl create cluster -f cluster.yaml

Cluster characteristics:

  • 3 AZs, public + private endpoints
  • Fargate profile selecting pods in namespace pollenix
  • OIDC provider enabled (for IRSA)
  • CloudWatch logging for api/audit/authenticator

Step 3 — Deploy the Helm chart

Terminal window
helm upgrade --install pollenix-core \
infra/aws/charts/pollenix-core \
--namespace pollenix --create-namespace \
--set image.tag=v0.1.0 \
-f infra/aws/charts/pollenix-core/values-dev.yaml

Replace values-dev.yaml with values-prod.yaml for production, after filling in the ARNs from your bootstrap output.

:::tip Wiring CI/CD Once you’re set up, configure EKS_CLUSTER_DEV / EKS_CLUSTER_STAGING / EKS_CLUSTER_PROD repo variables and use the included deploy · dev, deploy · staging, deploy · prod workflows — prod has an Environment reviewer gate. See the release · pollenix-core and deploy · prod workflow files in the repo. :::

Step 4 — DNS

Point your pollenix.<your-domain> at the ALB the chart creates:

Terminal window
kubectl -n pollenix get ingress

Take the ADDRESS field, add a CNAME at your DNS provider, wait for the ACM certificate validation to clear.

Step 5 — Open the wizard

Head to https://pollenix.<your-domain> and continue with the first-run wizard.