> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tensor9.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cluster

> Run multiple service adapter processes with shared coordination.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/tensor9/3qwgIru3kCfHriJC/images/diagrams/cloud-adapter-cluster-light.svg?fit=max&auto=format&n=3qwgIru3kCfHriJC&q=85&s=2baaa4f9f721ed8e4e252cfbe6674c48" alt="A cluster of Cloud Adapter processes shares coordination state while translating origin-cloud API calls to native target services." width="1200" height="600" data-path="images/diagrams/cloud-adapter-cluster-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/tensor9/3qwgIru3kCfHriJC/images/diagrams/cloud-adapter-cluster-dark.svg?fit=max&auto=format&n=3qwgIru3kCfHriJC&q=85&s=b3709452cdc7a2a2ca1b9e9033d60e29" alt="A cluster of Cloud Adapter processes shares coordination state while translating origin-cloud API calls to native target services." width="1200" height="600" data-path="images/diagrams/cloud-adapter-cluster-dark.svg" />
</Frame>

The **cluster** deployment runs multiple service-adapter processes behind one application-facing endpoint. The processes share PostgreSQL coordination state so they can make consistent decisions while scaling or restarting independently.

## When to use it

Choose a cluster when you need process-level redundancy, rolling restarts or more throughput than one binary can provide. The cluster does not change which API operations a mapping supports; it changes how the adapter is operated.

## What you operate

* Adapter processes and their rollout policy.
* The load-balancing or service-discovery layer in front of them.
* Shared PostgreSQL coordination state, including backup and recovery.
* Runtime credentials, destination-service access and network policy.

Keep coordination state separate from destination data in your inventory. A healthy process does not imply that either store is backed up or reachable.

## Rollouts

Use the local Tensor9 CLI to validate a configuration change, check compatibility and coordinate a rolling restart. Changes that require live migration between incompatible backends remain blocked until a migration path exists.
