Skip to main content

Orbitor Gateway (IPFS)

Background​

The Infrastructure team operates IPFS HTTP Gateway infrastructure (Orbitor) to provide public access to IPFS content via standard HTTP. The gateway uses the Rainbow IPFS gateway implementation and serves content at ipfs.orbitor.dev.

Architecture​

The Orbitor gateway infrastructure consists of:

  • IPFS Gateway nodes running Rainbow gateway software
  • Load balancing for high availability
  • Monitoring and alerting via Prometheus and PagerDuty

Services​

  • Public Gateway: ipfs.orbitor.dev - Public HTTP gateway for IPFS content

Deployment​

The IPFS gateway is deployed using Ansible playbooks located in:

  • infrastructure-general/ansible/ipfs-execution/

Deployment Steps​

  1. Get the latest image tag from Rainbow releases
  2. Update the image tag in the Ansible configuration
  3. Dry-run the deployment: ansible-playbook --check --diff
  4. Deploy the changes
  5. Verify the gateway is operational

Monitoring​

  • Metrics: Collected via Prometheus
  • Alerts: Routed to PagerDuty via pd-ipfs-infra-incidents-high integration
  • Logs: Collected via Promtail/Loki

Configuration​

Key configuration includes:

  • Gateway domain: ipfs.orbitor.dev
  • Denylist management for content filtering
  • Peering configuration for network connectivity
  • Storage and GC thresholds