MajorLinux
34aadae03a
Cover installation, Plex-optimized format selection, playlist downloading, config file, and background session usage. Cross-reference existing JS challenge troubleshooting article. Article count: 32 → 33. Open source section: 5 → 6. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
94 lines
3.2 KiB
Markdown
94 lines
3.2 KiB
Markdown
---
|
|
title: MajorWiki Deployment Status
|
|
status: deployed
|
|
project: MajorTwin
|
|
updated: '2026-03-12'
|
|
---
|
|
|
|
# MajorWiki Deployment Status
|
|
|
|
## Status: Deployed ✅
|
|
|
|
**URL:** https://notes.majorshouse.com
|
|
**Host:** majorlab (`/opt/majwiki`)
|
|
**Port:** 8092 (internal), proxied via Caddy
|
|
**Engine:** MkDocs Material (squidfunk/mkdocs-material)
|
|
|
|
## Stack
|
|
|
|
- Docker Compose at `/opt/majwiki/compose.yml`
|
|
- `network_mode: host` — container binds directly to host network
|
|
- MkDocs serves on `0.0.0.0:8092`
|
|
- Caddy proxies `notes.majorshouse.com → :8092`
|
|
- Let's Encrypt cert provisioned 2026-03-11, valid until 2026-06-09
|
|
|
|
## Why notes.majorshouse.com
|
|
|
|
`wiki.majorshouse.com` was provisioned and configured correctly but Google Fiber
|
|
blocks TLS handshakes for SNI hostnames containing "wiki" at the ISP level.
|
|
`notes.majorshouse.com` works fine on the same IP and port. `wiki.majorshouse.com`
|
|
DNS record and Caddy entry have been removed.
|
|
|
|
## Content
|
|
|
|
- 33 articles across 5 domains
|
|
- Source of truth: `MajorVault/20-Projects/MajorTwin/08-Wiki/`
|
|
- Deployed via Gitea webhook (push from MajorAir → auto-pull on majorlab)
|
|
|
|
## Update Workflow
|
|
|
|
```bash
|
|
# From MajorRig (majorlinux user)
|
|
rsync -av --include="*.md" --include="*/" --exclude="*" \
|
|
/mnt/c/Users/majli/Documents/MajorVault/20-Projects/MajorTwin/08-Wiki/ \
|
|
root@majorlab:/opt/majwiki/docs/
|
|
|
|
# MkDocs hot-reloads automatically — no container restart needed
|
|
```
|
|
|
|
## Backlog
|
|
|
|
- [✅] Gitea webhook for auto-deploy on push (Active as of 2026-03-11)
|
|
- [✅] Git repo initialized on MajorAir — push to deploy (2026-03-12)
|
|
- [✅] Troubleshooting section seeded with articles
|
|
- [ ] Add `03-opensource` articles
|
|
|
|
## Incident Log
|
|
|
|
### 2026-03-11 — 502 Error & Webhook Repair
|
|
- **Issue:** Wiki returned 502 Bad Gateway.
|
|
- **Cause:** `majwiki` container was in a restart loop due to a `LiterateNavParseError` in `SUMMARY.md` (invalid globbing syntax).
|
|
- **Repair:** Rewrote `SUMMARY.md` with explicit links. Repaired `majwiki-webhook.service` by killing an orphaned process and correcting the Caddy reverse proxy routing for `/webhook`.
|
|
- **Result:** Site live and auto-deployment functional.
|
|
|
|
---
|
|
|
|
*Updated 2026-03-13*
|
|
|
|
## Canonical Update Workflow
|
|
|
|
Obsidian Git plugin was evaluated and dropped — too convoluted. Manual git from the terminal is the workflow going forward.
|
|
|
|
```bash
|
|
cd ~/Documents/MajorVault
|
|
git add 20-Projects/MajorTwin/08-Wiki/
|
|
git commit -m "wiki: describe your changes"
|
|
git push
|
|
```
|
|
|
|
Gitea receives the push → fires webhook → majorlab pulls → MkDocs rebuilds → `notes.majorshouse.com` updates automatically.
|
|
|
|
## 📋 Wiki Maintenance Protocol
|
|
|
|
Every time a new article is added, the following **MUST** be updated to maintain index integrity:
|
|
|
|
1. **`SUMMARY.md`**: Add the article to the navigation tree.
|
|
2. **Category Index**: Update the `index.md` within the specific domain folder (e.g., `05-troubleshooting/index.md`).
|
|
3. **Main `index.md`**:
|
|
- Update the **Article count**.
|
|
- Add the article to the domain section.
|
|
- Add the article to the **Recently Updated** table.
|
|
4. **Root `README.md`**: Sync with the main `index.md` (Article count, domain lists, and Recently Updated).
|
|
|
|
> [!note] The rsync one-liner in the Update Workflow section above was a one-off during initial setup. It is no longer the canonical method.
|