blumeops/docs/reference/services/kiwix.md
Erich Blume c7a51ae253 Reject wiki-links with spaces and fix existing ones
Update doc-links task to detect and reject wiki-links that have spaces
in the target or around the pipe separator. Fix all 60 existing links
that had spaces (e.g., [[target | Text]] → [[target|Text]]).

This ensures compatibility with obsidian.nvim which doesn't handle
spaced wiki-links correctly.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 17:20:10 -08:00

52 lines
1.2 KiB
Markdown

---
title: kiwix
tags:
- service
- knowledge
---
# Kiwix
Offline Wikipedia and ZIM archive server.
## Quick Reference
| Property | Value |
|----------|-------|
| **URL** | https://kiwix.ops.eblu.me |
| **Tailscale URL** | https://kiwix.tail8d86e.ts.net |
| **Namespace** | `kiwix` |
| **Image** | `ghcr.io/kiwix/kiwix-serve:3.8.1` |
| **Storage** | NFS from [[sifaka|Sifaka]] (`/volume1/torrents`) |
## Architecture
| Component | Purpose |
|-----------|---------|
| kiwix-serve | Serves ZIM files on port 80 |
| torrent-sync | Sidecar syncing ZIM torrents to [[transmission]] |
| zim-watcher | CronJob (hourly) to restart on new ZIMs |
## Configured Archives
- Wikipedia top 1M English articles with images
- Project Gutenberg (60,000+ books)
- iFixit repair guides
- Stack Exchange (SuperUser, Math, etc.)
- LibreTexts textbooks
- DevDocs developer documentation
Full list: `argocd/manifests/kiwix/configmap-zim-torrents.yaml`
## Adding Archives
1. Edit `configmap-zim-torrents.yaml`
2. Add torrent URL from https://download.kiwix.org/zim/
3. Sync: `argocd app sync kiwix`
4. Torrent-sync adds to [[transmission]]
5. zim-watcher restarts kiwix when download completes
## Related
- [[transmission]] - Downloads ZIM files
- [[sifaka|Sifaka]] - ZIM storage