User & Admin Documentation

Everything you need to deploy, configure, and operate the Forge platform.

For backend architecture, API reference, database schema, and contributor guides, see the Developer Docs.

Getting Started

DocumentDescription
Architecture OverviewSystem diagrams, component roles, request flows, port reference
Docker DeploymentDeploy with Docker Compose, TLS, backups, scaling, troubleshooting
Kubernetes DeploymentHelm chart on k3s/kubeadm with HA control plane, ingress, PVCs
Operator v1.0.09 CRDs, multi-cluster control plane, declarative Workflow DAG, OLM bundle

Features

FeatureDescription
Event-Driven AutomationHMAC-verified webhooks with Jinja2 conditions
Drift DetectionConfiguration drift detection with alert rules and compliance export
Policy-as-Code (OPA)Rego rules for launch-time policy enforcement
Self-Service PortalAutomation catalog with approval workflows
Multi-TenancyPer-org quotas, branding, isolation
OIDC + WebAuthnSSO, FIDO2 passkeys, MFA enforcement
IaC Scanningansible-lint, checkov, pip-audit pre-launch scanning
ObservabilityOpenTelemetry traces and metrics
Dynamic SurveysRuntime choice resolution from DB, API, or Jinja2
Audit TrailImmutable security audit log with CSV/SIEM export
RecommendationsRule-based actionable improvement suggestions

AI Assistant

DocumentDescription
ArchitectureRAG pipeline, Ollama, ChromaDB, all-in-one container
API ReferenceChat, health, and indexing endpoints
ConfigurationEnvironment variables, model selection, document sources
DeploymentStandalone and integrated deployment, GPU support

Operations

DocumentDescription
User HandbookStep-by-step guide for every UI page with screenshots
Admin HandbookInstallation, day-2 operations, scaling, security, troubleshooting

Release Notes

VersionHighlights
v2026.05.0Platform GA — operator v1.0.0 (multi-cluster, 9 CRDs), 3m+4w k3s, all-in-one assistant
v2026.04.0EDA, AI Assistant, Dynamic Surveys, Audit Trail, 6 new features
v2026.03.0Initial release — modernized AWX with React UI