Skip to content

stellar: add cloud operator deployment guides for hosted relayer#190

Open
stevep0z wants to merge 1 commit into
mainfrom
feat/stellar-relayer-guides
Open

stellar: add cloud operator deployment guides for hosted relayer#190
stevep0z wants to merge 1 commit into
mainfrom
feat/stellar-relayer-guides

Conversation

@stevep0z

Copy link
Copy Markdown
Collaborator

Summary

Adds operator deployment guides for infrastructure teams running a self-hosted Stellar Channels relayer service. This PR includes a detailed GCP guide, with an AWS guide also coming in this PR.

Type of Change

  • New documentation

What

New guide: Hosted Stellar Relayer on GCP: Operator Deployment Guide

Covers end-to-end provisioning of the full GCP infrastructure stack:

  • Cloud Run (autoscaling) behind an External HTTPS Load Balancer with Google-managed SSL
  • Memorystore Redis (STANDARD_HA) for state and job scheduling
  • Pub/Sub topics/subscriptions for the distributed transaction pipeline
  • Secret Manager + Cloud KMS (ED25519) for secrets and signing
  • Artifact Registry remote repo proxying the ECR image
  • Optional Cloudflare Worker for API-key issuance, rate limiting, and analytics
  • Optional Cloud Functions for balance monitoring

Targeted at GCP-fluent operators who are new to the OZ relayer stack. Sized for production workloads (~2M+ tx/day across ~2,500 relayers).

An AWS operator deployment guide will also be added to this PR.

Both guides are added to the Stellar navigation under Relayer 1.5.x → Guides.

Why

Operators deploying the Stellar Channels service in their own cloud environments currently have no dedicated reference for standing up the full infrastructure stack. These guides close that gap.

Related Issues

N/A

Additional Notes

Guides written with significant contributions from @collins-w and @tirumerla.

@stevep0z stevep0z requested a review from a team as a code owner June 23, 2026 18:24
@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Deploy Preview for openzeppelin-docs-v2 ready!

Name Link
🔨 Latest commit 5c553ca
🔍 Latest deploy log https://app.netlify.com/projects/openzeppelin-docs-v2/deploys/6a3acf4ad3449100086cfe16
😎 Deploy Preview https://deploy-preview-190--openzeppelin-docs-v2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant