Installation
Inrupt Enterprise Solid Server (ESS) is deployed using Kustomize manifests on Kubernetes. Contact your Inrupt representative or Inrupt's Business Development team to obtain access.
PodSpaces (Developer Preview) Inrupt provides hosted versions of the Enterprise Solid Server, eliminating the installation overhead. For more information, see Inrupt PodSpaces
Prerequisites
Before installing ESS, ensure the following are available:
Kubernetes 1.28 or later — at least three worker nodes with 4 CPU and 8 GB RAM each
cert-manager installed in the cluster
PostgreSQL — one database per ESS service: five for a standard deployment, or seven if you also deploy the Solid OIDC Broker and WebID Service for Solid interoperability (see Advanced Configuration). The Search Service requires one additional database with the
pgvectorextension enabled. The databases can be hosted on a single PostgreSQL instance or on separate instances.Kafka message broker — three brokers recommended
S3-compatible object storage
OpenSearch — required only if you deploy the Search Service
Secrets management solution (e.g., Vault, AWS Secrets Manager)
Cloudsmith registry token — contact Inrupt to obtain registry credentials
ESS installation requires access to Inrupt's private Cloudsmith registry. Ensure your registry credentials are configured before proceeding.
The Terraform blueprints and the example Kustomize overlays currently deploy the Solid OIDC Broker, WebID Service, and Start Service by default. If you are deploying the standard configuration without Solid interoperability, exclude these services from your overlay and provision five databases rather than seven.
For full operational deployment steps including Kubernetes manifests and Kustomize overlays, see the ESS Kustomize repository (private; requires Inrupt customer access).
Getting Access
Container Registry Entitlement Token — pull ESS container images from Inrupt's private registry.
Terraform Repository (optional) — Terraform blueprints for provisioning ESS infrastructure (IdP, PostgreSQL, Kafka, etc.) on AWS.
Kustomize Repository — deployment manifests, components, and installation documentation. Can build on top of the Terraform-provisioned infrastructure, but Terraform is not required.
Installation Steps
1. Provision Infrastructure (optional)
If you are setting up a completely new, standalone deployment and do not have existing infrastructure, the Terraform repository provides blueprints to provision the required infrastructure (Identity Provider, PostgreSQL databases, Kafka, object storage) on AWS. Follow the documentation in the repository to get started. If you are deploying ESS onto existing infrastructure, you can skip this step and provision the required components inline with your existing infrastructure and tooling.
2. Deploy ESS
The Kustomize repository contains a quickstart guide and detailed installation documentation. Follow the repository documentation to:
Fork the repository and create your overlay
Configure your Identity Provider, database, and secrets
Deploy to your Kubernetes cluster
Customization
Once deployed, see Customize ESS for guidance on customizing your deployment, including:
Last updated