Architecture

Websoft9 is an application-centric microservices architecture.

Architecture philosophy

Everything is an application, everything can be assembled" is the basic philosophy of Websoft9, based on this philosophy, we flexibly integrate excellent open source software into our product system.

• Product Innovation through Assembly
• The Twelve-Factor App
• Open source iteration, continuous development
• Focus on connectivity and reduce non-essential original components
• Leverage elements of technology that are already popular and avoid creating new specifications
• GitOps Cloud-native continuous delivery model
• Unix philosophy KISS principle: Keep It Simple, Stupid!
• Infrastructure as Code (IaC)

Architecture diagram

Websoft9 uses a single-container integrated control plane architecture. All core services run inside one Docker container.

graph TB
    subgraph Host["Host Machine"]
        subgraph Container["Websoft9 Container"]
            Console["Console<br/>React 19 + TS + MUI<br/>:9000"]
            AppHub["AppHub<br/>Python FastAPI<br/>/api"]
            Gitea["Gitea<br/>Git Repository"]
            Portainer["Portainer<br/>Container Mgmt"]
            NPM["Nginx Proxy Manager<br/>Reverse Proxy & SSL<br/>:80 :443"]
        end
        DockerSocket["Docker Socket<br/>/var/run/docker.sock"]
        DataVolumes["Data Volumes<br/>/opt/websoft9/data"]
    end

    User["Browser"] -->|":9000"| Console
    Console -->|"/api/*"| AppHub
    AppHub --> Portainer
    AppHub --> NPM
    AppHub --> Gitea
    AppHub --> DockerSocket
    NPM -->|":80/:443"| Internet["External Network"]

Core Components

• Console: Web management UI built with React 19 + TypeScript + Vite + MUI, served at port 9000
• AppHub: Business logic API built with Python FastAPI, handles app management, auth, proxy, backup, and settings
• Gitea: Embedded Git repository service for hosting application templates and code
• Portainer: Embedded container management service for Docker container and stack lifecycle
• Nginx Proxy Manager: Reverse proxy handling domain binding and Let's Encrypt SSL certificates, bound to ports 80 and 443

Open Souce

Websoft9 uses Docker Compose as a template for applications, and maintained an open source repository docker-library with 200+ templates.

Applications running on Docker Compose can exist independently of Websoft9, which means maintenance and learning costs are extremely low.