victus-infra defines and operates the shared infrastructure runtime for the
Victus ecosystem.
The repository exists to keep the VPS runtime reproducible, portable, and
safe to deploy. It provides the infrastructure layer used by other Victus
repositories, but it does not contain product application code.
The core idea is:
one runtime source of truth, two execution modes: local and server
This repository owns:
This repository does not own:
This repository is moving toward a Hub-and-Node documentation model:
docs/000-SYSTEM-CONTEXT.md repository purpose, scope, concepts, navigation
docs/100-ARCHITECTURE.md system shape, components, runtime boundaries
docs/architecture/ modular architecture nodes
docs/200-OPERATIONS.md validation, deploy, maintenance, troubleshooting
docs/operations/ numbered operational runbooks
docs/300-CONTRACTS.md shared guarantees, interfaces, schemas, invariants
docs/decisions/ decision records and architectural rationale
Current documentation nodes:
runtime source of truth
: The Compose files in this repository define what runs. Deployment tooling
copies and starts them; it should not redefine the stack.
stack
: A deployable service group with a clear domain boundary. Current stacks are
core, observability, llm, and wiki.
core
: Shared infrastructure required by Victus consumers, including private edge
routing, object storage, durable registry state, event streaming, and private
DNS.
observability
: Monitoring and logging services used to inspect runtime health.
llm
: LiteLLM gateway, dynamic provider key management, and Langfuse LLM tracing.
wiki
: Public Wiki.js documentation served through the public NGINX edge.
private DNS
: Internal service naming under the victus.io zone, backed by CoreDNS.
shared contracts
: Stable expectations exposed to other repositories, including S3 layout,
Postgres registry schema, Redis Streams usage, and DNS names.
local mode
: Developer validation mode using local Compose overrides and test env files.
server mode
: Production mode where Ansible prepares the host and deploys the same
repository-owned runtime definitions.
compose/ Docker Compose projects, environment examples, and service configs
ansible/ VPS deployment playbooks, roles, inventory, and group vars
ops/ operational scripts, checks, and database migration tooling
tests/ validation scripts for deployment automation
docs/ current documentation nodes during the documentation migration
.github/ GitHub Actions workflows and deployment notes