Documentation map

The documentation is organized around the lifecycle of a Blacki installation.

Get started

• First VPS deployment is the supported Docker Compose path.
• Telegram setup connects the primary chat interface.
• Zepto MCP authenticates and protects the optional shared Zepto account.
• Local development covers uv, tests, and MkDocs.

Operate

• Configuration lists deployment and application settings.
• Day-two operations covers status, backups, upgrades, and rollback.
• Troubleshooting maps common symptoms to checks.
• Observability explains local logs and traces.

Understand

• Architecture describes runtime and persistence boundaries.
• Docker Compose explains the service contract.
• Docker image explains the multi-stage build and non-root runtime.

The MkDocs navigation in mkdocs.yml is the source of truth for the published information architecture.