6b1a61461b
Bootstraps an MkDocs Material documentation site (rendered to
docs.makerfloss.eu by the Forgejo Actions runner). The first feature
is an auto-generated hardware overview built from per-host YAML
frontmatter blocks under docs/hardware/.
- mkdocs.yml, requirements.txt: MkDocs Material 9.5 + pyyaml
- Makefile: docs-index | docs-build | docs-serve | docs-check
- scripts/gen_overview.py: stdlib + pyyaml generator, deterministic and
offline. Reads scripts/overview_config.yml — category-driven so
services/vms can plug in later without touching the script.
- scripts/overview_config.yml: hardware schema and index layout
- docs/hardware/{makerfloss,fisi,tembo}.md: 3 sample entries
- docs/hardware/index.md: GENERATED, committed (CI fails on drift)
- docs/index.md: site landing page
- .forgejo/workflows/docs.yml: drift-check + mkdocs build --strict +
rsync site/ to /srv/docs-makerfloss/html on push to main
- .gitignore: site/, .venv, __pycache__
Schema:
- hostname, kind, status (required; kind/status are enums)
- model, location, cpu, cpu_cores, cpu_threads, ram_gb, storage_gb,
storage_type (enum), storage_notes, nic_gbps (all optional)
- Filename stem MUST equal hostname (enforced by generator)
- Extra optional fields are accepted silently and live on the per-page
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
25 lines
633 B
Markdown
25 lines
633 B
Markdown
---
|
||
hostname: fisi
|
||
kind: server
|
||
status: in-use
|
||
model: HP MicroServer Gen10 Plus
|
||
location: home rack
|
||
cpu: Xeon E-2226G
|
||
cpu_cores: 6
|
||
cpu_threads: 12
|
||
ram_gb: 64
|
||
storage_gb: 8000
|
||
storage_type: hdd
|
||
storage_notes: ZFS mirror 2×8 TB HDD + 1 TB NVMe cache
|
||
nic_gbps: 1
|
||
---
|
||
|
||
# fisi
|
||
|
||
Primary home server in the baobab.band homelab. Hosts the bulk of
|
||
self-hosted services: Nextcloud, Jellyfin + *arr stack, Technitium DNS,
|
||
PhotoPrism, Matrix (conduwuit + Element), Forgejo (internal), Vaultwarden,
|
||
and more.
|
||
|
||
Not part of the MakerFLOSS infrastructure proper, listed here for
|
||
Proxmox-style placement planning when we eventually share workloads.
|