Skip to main content

System Architecture

Overview

Components

ComponentRole
Proxmox VE 13+Hypervisor — manages LXC containers via REST API. Nodes are registered Proxmox servers.
DNSMasqDHCP + DNS. Auto-assigns IPs to containers, provides internal name resolution (container.cluster.internal).
NGINXReverse proxy — L7 (HTTP/HTTPS with auto TLS via ACME) and L4 (TCP port mapping). Config auto-generated from container services.
LDAP GatewayNode.js LDAP server (source). Reads users/groups from the DB; containers authenticate via PAM/SSSD.
Push Notification Service2FA via push notifications (source). Configured in Settings. Used by LDAP gateway when AUTH_BACKENDS includes notification.
DatabasePostgreSQL via Sequelize ORM. Stores users, groups, sites, nodes, containers, and service config.

Data Flow

Container Creation

User Authentication

HTTP Service Exposure