Skip to content

Architecture

Understanding the Waveshift system architecture and design.

In This Section

  • System Overview - High-level architecture, component relationships, and system design

System Design

Waveshift is designed as a distributed system connecting cloud infrastructure with physical sites through secure VPN tunnels.

Key Components

  • Cloud Platform - AWS-hosted services (EC2, RDS, VPC)
  • Site Hubs - GL.iNet routers at physical locations
  • VPN Mesh - WireGuard-based secure networking
  • Orchestration - wavectl CLI and backend services

Architecture Principles

  • Security First - Encrypted communications, zero-trust design
  • Scalability - Support for multiple sites and services
  • Reliability - Redundancy and health monitoring
  • Simplicity - Complex infrastructure, simple operations