Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion web/content/self-hosting/downloads.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Used by [this guide](/docs/self-hosting/install-eks). Checksums: [`SHA256SUMS`](
| [`opensearch-roles-via-cluster.sh`](https://agentrelay.com/self-hosting/files/eks/opensearch-roles-via-cluster.sh) | `b43755a02f2972ad9f8b405b8f2c3acd20cf1f6d999009f1cbe644f3f4fa90b8` |
| [`rds-session-erase-search.sql`](https://agentrelay.com/self-hosting/files/eks/rds-session-erase-search.sql) | `148e8ca95cc74a398eb404b01d2e01c896252b516368f364d0886bccc1c19216` |
| [`rds-setup.sh`](https://agentrelay.com/self-hosting/files/eks/rds-setup.sh) | `c29aea950c6112eb10d974cb28e79a3273ae2af7b2ba8484a07afed48a9e0a83` |
| [`values.yaml`](https://agentrelay.com/self-hosting/files/eks/values.yaml) | `0e4ab38da4b033e341123227473c950ce8e67dc323aa348a8ba1eb9229822662` |
| [`values.yaml`](https://agentrelay.com/self-hosting/files/eks/values.yaml) | `dfd14e34f46285c6551114459b874d3e03a6a313e6a061106da203929ba8b3b5` |

## Google Cloud (GKE)

Expand Down
16 changes: 8 additions & 8 deletions web/content/self-hosting/install-aks.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Install Agent Relay on Azure Kubernetes Service. It follows
forces. Run the steps in order and check each **Done when** line before you
move on.

**Release:** `agent-relay-2026.11.5` (chart 0.7.10). **Community-contributed**:
**Release:** `agent-relay-2026.11.16` (chart 0.7.54). **Community-contributed**:
proven once on AKS, see [Known limits](#known-limits).

**Status: community-contributed, proven once.** One fresh install on
Expand All @@ -19,8 +19,8 @@ operator device approval worked, two agents exchanged messages through
Relaycast, and an uploaded session was indexed. See
[Known limits](#known-limits) before a production rollout.

This guide installs release **agent-relay-2026.11.5** (chart agent-relay 0.7.10,
sessions-pipeline 0.8.33). `searchIndexer.locker.credentials` first shipped
This guide installs release **agent-relay-2026.11.16** (chart agent-relay 0.7.54,
sessions-pipeline 0.8.47). `searchIndexer.locker.credentials` first shipped
in agent-relay-2026.11.2. Earlier releases do not render the
indexer's MinIO keys, so its uploads are never indexed.

Expand Down Expand Up @@ -63,15 +63,15 @@ command runs in `docs/azure-install`:

```sh
git clone https://github.com/AgentWorkforce/infra.git && cd infra/docs/azure-install
mkdir release && gh release download agent-relay-2026.11.5 -R AgentWorkforce/infra -D release
(cd release && shasum -a 256 -c SHA256SUMS && tar -xzf agent-relay-0.7.10.tgz) | tail -1
mkdir release && gh release download agent-relay-2026.11.16 -R AgentWorkforce/infra -D release
(cd release && shasum -a 256 -c SHA256SUMS && tar -xzf agent-relay-0.7.54.tgz) | tail -1
# Public GHCR images: no mirror root.
sed 's#__IMAGE_MIRROR_ROOT__/##' release/release-images.values.yaml > release-images.values.yaml
CHART=release/agent-relay-0.7.10.tgz
CHART=release/agent-relay-0.7.54.tgz
```

No `gh`? Download the same assets from the
[release page](https://github.com/AgentWorkforce/infra/releases/tag/agent-relay-2026.11.5)
[release page](https://github.com/AgentWorkforce/infra/releases/tag/agent-relay-2026.11.16)
into `release/`.

**Done when:** every checksum line ends in `OK` (the last is
Expand Down Expand Up @@ -307,7 +307,7 @@ codes and verification are in the
## Known limits

- Any release other than agent-relay-2026.11.0 (patched); `values.yaml` renders
against agent-relay-2026.11.5 but was not installed from it.
against agent-relay-2026.11.16 but was not installed from it.
- The output facts bootstrap (step 10).
- Azure Database for PostgreSQL, Azure Blob Storage, Application Gateway.
- NetworkPolicy enforcement beyond a default install, private clusters,
Expand Down
33 changes: 17 additions & 16 deletions web/content/self-hosting/install-eks.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,12 @@ Run the steps in order. Copy each block, replace every `<...>`, and check the
**Done when** line before you move on. Expect about two hours, most of it
waiting on AWS.

**Release:** `agent-relay-2026.11.5` (infra commit `ef3f69ab`, chart 0.7.10).
**Release:** `agent-relay-2026.11.16` (infra commit `ece71b9d`, chart 0.7.54).
These steps were run end to end on an existing EKS cluster on 2026-11-14:
installed with `agent-relay-2026.11.3`, then upgraded to this release with
[Upgrades](/docs/self-hosting/upgrades). To run a newer release, install this
one and then follow Upgrades.
installed with `agent-relay-2026.11.3`, then upgraded to `agent-relay-2026.11.5`
with [Upgrades](/docs/self-hosting/upgrades). `values.yaml` renders against
`agent-relay-2026.11.16` but was not installed from it. To run a newer release,
install this one and then follow Upgrades.

**You need:**

Expand Down Expand Up @@ -49,8 +50,8 @@ curl -fsSLO "$base/SHA256SUMS"
for f in $(awk '{print $2}' SHA256SUMS); do curl -fsSLO "$base/$f"; done
shasum -a 256 -c SHA256SUMS
git clone https://github.com/AgentWorkforce/infra.git
git -C infra checkout agent-relay-2026.11.5
test "$(git -C infra rev-parse HEAD)" = ef3f69ab8e557fb9282eb292b6975c210501c61f && echo "release ok"
git -C infra checkout agent-relay-2026.11.16
test "$(git -C infra rev-parse HEAD)" = ece71b9df93df64cb63676d2a0ca2767eccc6599 && echo "release ok"
```

Tools: `terraform` 1.11 or later, `helm` 3.10 or later (Helm 3, not Helm 4),
Expand Down Expand Up @@ -252,7 +253,7 @@ export AWS_REGION=<region>
export ALB_SUBNET_CIDR_A=<CIDR of load balancer subnet 1>
export ALB_SUBNET_CIDR_B=<CIDR of load balancer subnet 2>
export IMAGE_REPO_PREFIX=ghcr.io/agentworkforce
export SERVICES_IMAGE=ghcr.io/agentworkforce/sessions-pipeline@sha256:ba02f1498d53a089da7ff8fdb7e47215f561c55d9f292e1995b7b5c97d9c37a1
export SERVICES_IMAGE=ghcr.io/agentworkforce/sessions-pipeline@sha256:fd2efd61dca4761dfb55256aa4797cb7f61c3434cc8af4833287e0e7bb7b59a9
export PSQL_IMAGE=ghcr.io/cloudnative-pg/postgresql:17-standard-trixie@sha256:ed6923f9ba2399cf9070379a353c710c29ced8a294be73986a2c3dae7e599ce3
export NAMESPACE=agent-relay
export INSTALL_DIR="$PWD" # run "source settings.sh" from the agent-relay-install folder
Expand Down Expand Up @@ -725,10 +726,10 @@ first four; `rds-setup.sh` runs the services image and the PostgreSQL client.

| Image | Version | `image@digest` |
|---|---|---|
| Control API | `c276e638` | `ghcr.io/agentworkforce/relay-control@sha256:46e2cb514ba2ab3ec753fb3f3c0e17caff562350cbb671dbfc9f49b9463e0d49` |
| Dashboard | `0090a040` | `ghcr.io/agentworkforce/relay-webapp@sha256:9414d55446bbd4db9c82e344c109a4e829d76f536a49bd5917e7ebcc86ed3f23` |
| Relaycast | 12.8.0-pg.3 | `ghcr.io/agentworkforce/relaycast-self-host@sha256:cc2a79f02d39978fa04322b5a45497737ff137bc2a5db5615c7eee690030de83` |
| Sessions services | `f8ac49b3` | `ghcr.io/agentworkforce/sessions-pipeline@sha256:ba02f1498d53a089da7ff8fdb7e47215f561c55d9f292e1995b7b5c97d9c37a1` |
| Control API | 0.5.34 (`2258889a`) | `ghcr.io/agentworkforce/relay-control@sha256:377bc2b9477d0bbd966cccd61380dd9d7f6e022a76ff0f7ad80e391d56ec0a83` |
| Dashboard | `be770cac` | `ghcr.io/agentworkforce/relay-webapp@sha256:da0cc80476eac734299c0c6ceb94e2bca7dae7913cce56a8ca8592cf086dd02e` |
| Relaycast | 12.10.0 | `ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af15cf575b53a71d7eb09f2e6ab6e7c0d5be2da35339a275a5c6cc` |
| Sessions services | `b96e1e1e` | `ghcr.io/agentworkforce/sessions-pipeline@sha256:fd2efd61dca4761dfb55256aa4797cb7f61c3434cc8af4833287e0e7bb7b59a9` |
| PostgreSQL client | 17-standard-trixie | `ghcr.io/cloudnative-pg/postgresql:17-standard-trixie@sha256:ed6923f9ba2399cf9070379a353c710c29ced8a294be73986a2c3dae7e599ce3` |

Each image line in `values.yaml` sits under `x-pins`. Don't swap an image on
Expand All @@ -749,10 +750,10 @@ export ECR=<account>.dkr.ecr.<region>.amazonaws.com
aws ecr get-login-password --region "$AWS_REGION" | crane auth login "$ECR" -u AWS --password-stdin
copied=0
for src in \
ghcr.io/agentworkforce/relay-control@sha256:46e2cb514ba2ab3ec753fb3f3c0e17caff562350cbb671dbfc9f49b9463e0d49 \
ghcr.io/agentworkforce/relay-webapp@sha256:9414d55446bbd4db9c82e344c109a4e829d76f536a49bd5917e7ebcc86ed3f23 \
ghcr.io/agentworkforce/relaycast-self-host@sha256:cc2a79f02d39978fa04322b5a45497737ff137bc2a5db5615c7eee690030de83 \
ghcr.io/agentworkforce/sessions-pipeline@sha256:ba02f1498d53a089da7ff8fdb7e47215f561c55d9f292e1995b7b5c97d9c37a1 \
ghcr.io/agentworkforce/relay-control@sha256:377bc2b9477d0bbd966cccd61380dd9d7f6e022a76ff0f7ad80e391d56ec0a83 \
ghcr.io/agentworkforce/relay-webapp@sha256:da0cc80476eac734299c0c6ceb94e2bca7dae7913cce56a8ca8592cf086dd02e \
ghcr.io/agentworkforce/relaycast-self-host@sha256:ec062ef901af15cf575b53a71d7eb09f2e6ab6e7c0d5be2da35339a275a5c6cc \
ghcr.io/agentworkforce/sessions-pipeline@sha256:fd2efd61dca4761dfb55256aa4797cb7f61c3434cc8af4833287e0e7bb7b59a9 \
ghcr.io/cloudnative-pg/postgresql@sha256:ed6923f9ba2399cf9070379a353c710c29ced8a294be73986a2c3dae7e599ce3
do
repo="agent-relay/${src%@*}"; digest="${src#*@}"
Expand All @@ -773,6 +774,6 @@ whole block again; images already copied are quick.
Then, in `settings.sh` (step 6):

- `IMAGE_REPO_PREFIX=$ECR/agent-relay/ghcr.io/agentworkforce`;
- `SERVICES_IMAGE=$ECR/agent-relay/ghcr.io/agentworkforce/sessions-pipeline@sha256:ba02f149…`
- `SERVICES_IMAGE=$ECR/agent-relay/ghcr.io/agentworkforce/sessions-pipeline@sha256:fd2efd61…`
and `PSQL_IMAGE=$ECR/agent-relay/ghcr.io/cloudnative-pg/postgresql@sha256:ed6923f9…`,
with the full digests from the loop.
23 changes: 12 additions & 11 deletions web/content/self-hosting/install-gke.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,9 @@ Run the steps in order. Copy each block, replace every `<...>`, and check the
**Done when** line before you move on. Expect about an hour and a half, most of
it waiting on Google Cloud: the HTTPS certificate alone can take up to an hour.

**Release:** `agent-relay-2026.11.9` (infra commit `5370050a`, chart 0.7.21).
Read [Known limits](#known-limits) before a production rollout.
**Release:** `agent-relay-2026.11.16` (infra commit `ece71b9d`, chart 0.7.54).
The downloadable `values.yaml` renders against this release, which was not
installed on GKE. Read [Known limits](#known-limits) before a production rollout.

**You need:**

Expand Down Expand Up @@ -55,14 +56,14 @@ curl -fsSLO "$base/SHA256SUMS"
for f in $(awk '{print $2}' SHA256SUMS); do curl -fsSLO "$base/$f"; done
shasum -a 256 -c SHA256SUMS
git clone https://github.com/AgentWorkforce/infra.git
git -C infra checkout agent-relay-2026.11.9
test "$(git -C infra rev-parse HEAD)" = 5370050a974f330b120831ef376903ff2f7447b7 && echo "release ok"
mkdir release && gh release download agent-relay-2026.11.9 -R AgentWorkforce/infra -D release
(cd release && shasum -a 256 -c SHA256SUMS && tar -xzf agent-relay-0.7.21.tgz) | tail -1
git -C infra checkout agent-relay-2026.11.16
test "$(git -C infra rev-parse HEAD)" = ece71b9df93df64cb63676d2a0ca2767eccc6599 && echo "release ok"
mkdir release && gh release download agent-relay-2026.11.16 -R AgentWorkforce/infra -D release
(cd release && shasum -a 256 -c SHA256SUMS && tar -xzf agent-relay-0.7.54.tgz) | tail -1
```

No `gh`? Download the same assets from the
[release page](https://github.com/AgentWorkforce/infra/releases/tag/agent-relay-2026.11.9)
[release page](https://github.com/AgentWorkforce/infra/releases/tag/agent-relay-2026.11.16)
into `release/`.

Tools: `gcloud` (with `gke-gcloud-auth-plugin`), `terraform` 1.11 or later (or
Expand Down Expand Up @@ -313,7 +314,7 @@ export MIRROR_ROOT=<region>-docker.pkg.dev/<project id>/agent-relay-mirror
export NAMESPACE=agent-relay
export HELM_RELEASE=agent-relay
export STATIC_IP_NAME=agent-relay-ingress
export SERVICES_IMAGE=$MIRROR_ROOT/ghcr.io/agentworkforce/sessions-pipeline@sha256:3d9c0a4dff67c92da30964857713e625f3f967bc2ff98851614a70adbb4fe3fe
export SERVICES_IMAGE=$MIRROR_ROOT/ghcr.io/agentworkforce/sessions-pipeline@sha256:fd2efd61dca4761dfb55256aa4797cb7f61c3434cc8af4833287e0e7bb7b59a9
export PSQL_IMAGE=$MIRROR_ROOT/ghcr.io/cloudnative-pg/postgresql@sha256:ed6923f9ba2399cf9070379a353c710c29ced8a294be73986a2c3dae7e599ce3
export INSTALL_DIR="$PWD" # run "source settings.sh" from the agent-relay-install folder
export CHART="$INSTALL_DIR/release/agent-relay"
Expand Down Expand Up @@ -449,7 +450,7 @@ instead of this block. vals works with Google Secret Manager.
## 11. Install with Helm

```sh
helm upgrade --install $HELM_RELEASE "$INSTALL_DIR/release/agent-relay-0.7.21.tgz" --namespace $NAMESPACE \
helm upgrade --install $HELM_RELEASE "$INSTALL_DIR/release/agent-relay-0.7.54.tgz" --namespace $NAMESPACE \
-f "$CHART/values-gcp.yaml" -f "$CHART/values-gcp-native.yaml" \
-f "$INSTALL_DIR/managed-values.json" -f "$INSTALL_DIR/values.yaml" \
-f "$INSTALL_DIR/release-images.values.yaml" --timeout 25m
Expand Down Expand Up @@ -485,7 +486,7 @@ done
bash cloud-sql-setup.sh post
kubectl -n $NAMESPACE rollout restart deploy/agent-relay-read-api deploy/agent-relay-ingest-edge deploy/agent-relay-search-indexer
for j in $(kubectl -n $NAMESPACE get jobs -o name | grep search-indexer-bootstrap); do kubectl -n $NAMESPACE delete "$j"; done
helm upgrade --install $HELM_RELEASE "$INSTALL_DIR/release/agent-relay-0.7.21.tgz" --namespace $NAMESPACE \
helm upgrade --install $HELM_RELEASE "$INSTALL_DIR/release/agent-relay-0.7.54.tgz" --namespace $NAMESPACE \
-f "$CHART/values-gcp.yaml" -f "$CHART/values-gcp-native.yaml" \
-f "$INSTALL_DIR/managed-values.json" -f "$INSTALL_DIR/values.yaml" \
-f "$INSTALL_DIR/release-images.values.yaml" --timeout 25m
Expand Down Expand Up @@ -916,7 +917,7 @@ equal to the `proven` in the plan line you kept, and `exit 0`.

## Known limits

What release `agent-relay-2026.11.9` doesn't do on GKE yet:
What release `agent-relay-2026.11.16` doesn't do on GKE yet:

1. **Upgrading from 2026.11.5 or earlier: re-stamp once.** Those releases
recorded sessions uploaded to Cloud Storage as if they were in S3, so their
Expand Down
3 changes: 2 additions & 1 deletion web/content/self-hosting/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,8 @@ yourself.
| `agent-relay-2026.11.6` (infra commit `6b98a4ab`) | 0.7.11 | GKE |
| `agent-relay-2026.11.7` (infra commit `b63ec4a3`) | 0.7.14 | GKE |
| `agent-relay-2026.11.8` (infra commit `e15513ba`) | 0.7.15 | GKE |
| `agent-relay-2026.11.9` (infra commit `5370050a`) | 0.7.21 | [GKE](/docs/self-hosting/install-gke) (current; see its [known limits](/docs/self-hosting/install-gke#known-limits)) |
| `agent-relay-2026.11.9` (infra commit `5370050a`) | 0.7.21 | GKE |
| `agent-relay-2026.11.16` (infra commit `ece71b9d`) | 0.7.54 | [EKS](/docs/self-hosting/install-eks), [GKE](/docs/self-hosting/install-gke) and [AKS](/docs/self-hosting/install-aks) (current; see the [GKE known limits](/docs/self-hosting/install-gke#known-limits) and [AKS known limits](/docs/self-hosting/install-aks#known-limits)) |

Charts, Terraform and helper scripts come from the public
[AgentWorkforce/infra](https://github.com/AgentWorkforce/infra) repository at a
Expand Down
2 changes: 1 addition & 1 deletion web/public/self-hosting/files/eks/SHA256SUMS
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,4 @@ d2208cdf9011cd06fb103250da1fc9129b69dc6f4119456da531593c2728f1d7 okta-setup.sh
b43755a02f2972ad9f8b405b8f2c3acd20cf1f6d999009f1cbe644f3f4fa90b8 opensearch-roles-via-cluster.sh
148e8ca95cc74a398eb404b01d2e01c896252b516368f364d0886bccc1c19216 rds-session-erase-search.sql
c29aea950c6112eb10d974cb28e79a3273ae2af7b2ba8484a07afed48a9e0a83 rds-setup.sh
0e4ab38da4b033e341123227473c950ce8e67dc323aa348a8ba1eb9229822662 values.yaml
dfd14e34f46285c6551114459b874d3e03a6a313e6a061106da203929ba8b3b5 values.yaml
8 changes: 4 additions & 4 deletions web/public/self-hosting/files/eks/values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,8 @@
# workload using it takes both from here. To move to a newer build or a new image
# name, change only that line. See the Images table at agentrelay.com/docs/self-hosting/install-eks.
x-pins:
services-image: &services_image { repository: __IMAGE_REPO_PREFIX__/sessions-pipeline, digest: "sha256:ba02f1498d53a089da7ff8fdb7e47215f561c55d9f292e1995b7b5c97d9c37a1" }
webapp-image: &webapp_image { repository: __IMAGE_REPO_PREFIX__/relay-webapp, digest: "sha256:9414d55446bbd4db9c82e344c109a4e829d76f536a49bd5917e7ebcc86ed3f23" }
services-image: &services_image { repository: __IMAGE_REPO_PREFIX__/sessions-pipeline, digest: "sha256:fd2efd61dca4761dfb55256aa4797cb7f61c3434cc8af4833287e0e7bb7b59a9" }
webapp-image: &webapp_image { repository: __IMAGE_REPO_PREFIX__/relay-webapp, digest: "sha256:da0cc80476eac734299c0c6ceb94e2bca7dae7913cce56a8ca8592cf086dd02e" }

components:
relaycast: true
Expand Down Expand Up @@ -55,7 +55,7 @@ relaycast:
postgres:
image:
repository: __IMAGE_REPO_PREFIX__/relaycast-self-host
digest: sha256:cc2a79f02d39978fa04322b5a45497737ff137bc2a5db5615c7eee690030de83
digest: sha256:ec062ef901af15cf575b53a71d7eb09f2e6ab6e7c0d5be2da35339a275a5c6cc
postgresCa:
enabled: true
configMap: rds-ca
Expand Down Expand Up @@ -279,7 +279,7 @@ sessions-pipeline:
relay-control:
image:
repository: __IMAGE_REPO_PREFIX__/relay-control
digest: sha256:46e2cb514ba2ab3ec753fb3f3c0e17caff562350cbb671dbfc9f49b9463e0d49
digest: sha256:377bc2b9477d0bbd966cccd61380dd9d7f6e022a76ff0f7ad80e391d56ec0a83
# The chart allows one replica: login and device rate limits are per process.
replicaCount: 1
existingSecret: agent-relay-secrets
Expand Down
Loading