Documentation

Zenpower Technical Overview

This portal provides operator-facing guidance without exposing private code or personal data. Every section links back to living documentation inside the Zenpower knowledge base.

Last index build yesterday · 22 Oct 2025, 08:19.

Platform Status Public Footprint Community Feed
Snapshot

Documentation feed at a glance

The docs index is rebuilt by tooling before deployments. Counts below only include public-safe material after keyword filtering.

Categories

8

Entries

511

Index build

yesterday · 22 Oct 2025, 08:19

Architecture

High-level system map

Zenpower is organised as a modular platform: a hardened operations core, sandbox environments for integration work, and a documentation/MCP layer for operator enablement. Subdomains mirror these responsibilities.

Core surfaces

  • zenpower.at / www.zenpower.at — Landing + operator onboarding
  • api.zenpower.at — FastAPI service tier with Prometheus health
  • admin.zenpower.at — ZenControl web console gated by OIDC/forward-auth
  • status.zenpower.at — Public health snapshots & release notes

Sandbox & demos

  • test.zenpower.at — QA sandboxes (Odoo/Shopware) seeded for safe integration drills
  • demo.zenpower.at — Showcase environment for guided tours and AI walkthroughs
  • odoo.test.zenpower.at / odoo.demo.zenpower.at — Namespaced ERP endpoints
  • astro-preview/test-preview/demo-preview.zenpower.at — Ephemeral preview hosts

Knowledge & control plane

  • docs.zenpower.at — Sanitised documentation portal (this site)
  • social.zenpower.at — Public-safe dispatches summarising deploys, docs, and guardrails
  • mcp.zenpower.at — Model Context Protocol API for agents and tooling
  • sso.zenpower.at — Identity provider (OIDC) for administrative surfaces
  • mail.zenpower.at — SMTP ingress with active monitoring & honeypot lab
Operations

Operating principles

Every deployment follows documented guardrails: immutable infrastructure, TLS enforcement, access logging, and AI/human collaboration workflows recorded in the status ledger.

  1. Infrastructure: Docker Compose orchestrated by systemd (zenpower.service) with rootless workers and aggressive seccomp defaults.
  2. Secrets: Environment values sourced from encrypted vault material; no secrets in the public repo.
  3. Certificates: Traefik acquires ACME certificates for each subdomain; ops/checks.sh fails if issuers drift.
  4. Observability: make health-matrix captures admin/API/worker health plus backup timers into zenpower/docs/en/status/health_matrix.json.
  5. Audit: Deployment history appended to docs/en/status/deploy_log.md; landing links surface these achievements.
Documentation map

Curated public-safe references

The lists below reference documentation families that can be shared externally. Private material remains within the Git repository and is not exposed here.

Need deeper insight? Request temporary GitHub access or consult the internal knowledge base via ZenControl. All access is logged and reviewed.

Explore the Zenpower surfaces

Each module shares the same synthwave calm—pick a surface to keep exploring.

CORE

Docs Portal

Navigable knowledge with manifest-driven deep links.

Explore docs

CORE

Social Dispatch

Public-safe deploy notes and community highlights.

Read dispatch

CORE

Identity SSO

Forward-auth + Keycloak guardrails for operators.

Review access