Skip to main content

Services Documentation

This section documents each service deployed by Soverstack.

Core Infrastructure Services

ServicePurposeDocumentation
VyOS FirewallNetwork security, routingFirewall rules, NAT, VPN
PowerDNSAuthoritative DNSZone management, DNSSEC
dnsdistDNS load balancingQuery routing, caching

Networking Services

ServicePurposeDocumentation
Headscale VPNZero-trust networkingMesh VPN, ACLs
HAProxyLoad balancingTCP/HTTP balancing

Security Services

ServicePurposeDocumentation
Keycloak IAMIdentity managementSSO, OIDC, SAML
OpenBao SecretsSecrets managementKV store, PKI, transit

Database Services

ServicePurposeDocumentation
PostgreSQL + PatroniRelational databaseHA, replication, backup

Observability Services

ServicePurposeDocumentation
Prometheus MonitoringMetrics collectionScraping, alerting rules
Grafana DashboardsVisualizationDashboards, data sources
Loki LoggingLog aggregationLogQL, retention
Wazuh SIEMSecurity monitoringThreat detection, compliance

Service Architecture

High Availability Patterns

All production services follow HA patterns:

PatternServicesDescription
Active-PassiveVyOS, PostgreSQLVRRP failover
Active-Activednsdist, HAProxyLoad balanced
Clusteretcd, PatroniConsensus-based
MeshHeadscale, LokiPeer-to-peer

Service Dependencies

Configuration Sources

Services are configured from multiple layers:

LayerProvides
platform.yamlDomain, tier, datacenter
networking.yamlVPN, DNS, firewall rules
compute.yamlVM specs, placement
databases.yamlDatabase connections
security.yamlIAM, secrets
apps.yamlSubdomain routing