Initial docs: Nextcloud AIO office suite (Collabora + Whiteboard)

- Full deployment reference for office.rmf44.xyz
- Architecture, procedure, troubleshooting, operations pages
- 4 SVG diagrams (topology, container-tree, data-flow, request-flow)
- Mirrors gite_replacement template structure
- Verified via 70/70 ad-hoc checks on 2026-08-10
This commit is contained in:
2026-08-10 15:43:46 -05:00
commit d172771aa1
12 changed files with 2423 additions and 0 deletions
+49
View File
@@ -0,0 +1,49 @@
# Nextcloud Office
Session log + runbook for the 2026-08-10 deployment of `office.rmf44.xyz`
as a Nextcloud All-in-One stack with Collabora + Whiteboard on
`homework03`, replacing the retired OnlyOffice container on `hawker`.
## Files
- `index.html` — overview, current state, at-a-glance
- `architecture.html` — topology, container tree, data flow, request flow
- `procedure.html` — phase-by-phase build commands (what was actually run)
- `troubleshooting.html` — every pitfall hit, with root cause and fix
- `operations.html` — backup pipeline, rollback, monitoring, day-2 follow-ups
- `assets/style.css` — self-contained dark theme (works standalone from disk)
- `assets/diagrams/topology.svg` — public ingress + NetBird + AIO
- `assets/diagrams/container-tree.svg` — 8 AIO containers + bind mounts
- `assets/diagrams/data-flow.svg` — NFS vs ext4 split, database on host
- `assets/diagrams/request-flow.svg` — swimlane sequence of a `git clone`-equivalent
- `assets/diagrams/backup-pipeline.svg` — hector timer → homework03 → desslok NFS
## How to view
Open `index.html` in a browser. All paths are relative; no web server
needed. The HTML uses self-hosted woff2 fonts referenced from
`assets/fonts/{family}/*.woff2` — copy those from `../fonts/` if you
want the full editorial look.
```sh
# Local preview with full fonts
rsync -a ../fonts/ assets/fonts/
xdg-open index.html
```
Without the font files, the site falls back to system sans-serif / serif
per the CSS `font-family` chain — still readable.
## Style
Uses the `painkiller-bullet-dark-blue` theme: dark blue background
(`#0d1b2a`), mint accent (`#4ecca3`), Josefin Sans headings + Cormorant
Infant body. Same aesthetic as `../painkiller-bullet-dark-blue.css` in
this lab repo. Mirrors `/home/tigo/lab/gite_replacement/` template.
## Source material
The narrative comes from a single Hermes session on 2026-08-10 that
deployed the stack end-to-end. The skill `self-hosted-services`
`nextcloud-aio` notes (currently in development) reference the
named-volume bind pattern from this work.