apex-os-docs/ARCHITECTURE.md

APEX OS Architecture

Last Updated: 2026-07-02

Overview

APEX OS is a self-hosted AI operating system running on Docker.

Components

• Infrastructure: Docker, Traefik, PostgreSQL, Redis
• AI Platform: LiteLLM, Ollama, OpenRouter, Open WebUI
• Development: Gitea, Code-Server, n8n, Dockge
• Monitoring: Grafana, Prometheus, Loki
• Security: Vaultwarden, Docker Socket Proxy

Network

All services on apex_apex-net bridge network. Public access via Traefik reverse proxy with Let's Encrypt SSL.

Data Flow

User -> Traefik (SSL/Routing) -> Service Container -> PostgreSQL/Redis

Service Dependencies

• All services depend on Docker and Traefik
• AI services depend on LiteLLM as gateway
• Monitoring depends on Prometheus for metrics collection