Manage your Gateway

Learn how to import pre-synchronized database snapshots to quickly bootstrap your gateway and reduce initial sync time from weeks to hours.

Step-by-step guide to safely upgrade your ar.io Gateway to the latest version without losing data or progress.

Authorize an operations address to update your gateway's metadata and claim the ArNS gateway operator discount, so your operator wallet can stay offline.

Deploy and configure Grafana to monitor your gateway's health and performance.

Configure advanced filters to efficiently process and index only the data you need, optimizing performance and resource usage.

Configure the CDB64 index for O(1) data item lookups. Three indexes are enabled by default, covering close to 3.8 billion records, so historical data items resolve locally.

Subscribe to another gateway's signed indexes so your gateway finds data items locally, or publish your own.

Customize your gateway's root domain to serve custom content, project information, or documentation instead of default network info.

Configure the x402 payment protocol so clients can pay in cryptocurrency for data beyond their free allowance.

Implement content moderation policies using blocklisting and filtering to control what content your gateway serves.

Reference for every ar.io gateway environment variable, organized by service component.

The gateway's command-line tool for index bands and the L1 index, with JSON on stdout. Release 85 or later.

The ar-io-node repo ships a Claude Code skill at .claude/skills/ar-io-gateway-operator/ with a one-screen scripts/health-check snapshot and an operational runbook covering the ANS-104 pipeline, ClickHouse, ArNS resolution, observer/cranker, and common pitfalls. Claude Code auto-loads it when run from the repo root. Readable as plain Markdown if you don't use Claude Code.

Troubleshooting guide and FAQ for common gateway issues, failed epoch guidance, and frequently asked questions.