Technical documentation for Finch, a minimal, self-hosted observability
stack that provides logs, metrics, and profiling out of the box with secure
agent enrolment handled by finchctl.
| Repository | Description |
|---|---|
| tschaefer/finch | Finch service - gRPC backend, agent management, mTLS auth |
| tschaefer/finchctl | CLI controller - stack deployment, agent enrolment, token management |
| tschaefer/finch-docs | This repository - Zensical documentation site |
The documentation is published at https://tschaefer.github.io/finch-docs/ and covers:
- Stack overview and architecture
- Deployment workflow and TLS options
- Finch service internals (agent management, authentication, dashboard)
- Agent configuration and token renewal
- Security model
- CLI reference
- Step-by-step tutorials
git clone https://github.com/tschaefer/finch-docs
cd finch-docs
python3 -m venv venv
source venv/bin/activate
pip install zensical
zensical build --clean
zensical serve