From 0ba3049090f033cbd12448aed286f2ac4706dcf9 Mon Sep 17 00:00:00 2001 From: Charles N Wyble Date: Mon, 2 Mar 2026 18:10:28 -0500 Subject: [PATCH] docs: add migration status file --- status.md | 125 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 125 insertions(+) create mode 100644 status.md diff --git a/status.md b/status.md new file mode 100644 index 0000000..3d3e3de --- /dev/null +++ b/status.md @@ -0,0 +1,125 @@ +# Grav Multi-Site Migration Status + +**Date:** March 2, 2026 +**Monorepo:** `/home/charles/Projects/tsysstatic/staticsites.turnsys.com/` +**Remote:** `ssh://git@git.knownelement.com:29418/TSYSGroupCorporate/tsysstaticsites.git` +**Cloudron Grav:** staticsites.turnsys.com + +--- + +## Completed + +- [x] All 21 sites converted from mdbook to Grav format +- [x] All repos merged into monorepo (preserves history) +- [x] Repository structure flattened: `pages/{fqdn}/*` (not `pages/{fqdn}/pages/*`) +- [x] setup.php created for hostname-based routing +- [x] Changes committed and pushed to remote +- [x] Cloudron: setup.php placed at `/app/data/user/setup.php` +- [x] Cloudron: Git Sync plugin installed and configured +- [x] Cloudron: Git Sync successfully pulled content +- [x] Cloudron: Admin plugin reinstalled after Git Sync wipe + +## Current State + +### Repository Structure +``` +pages/ +├── charters.turnsys.com/ +│ ├── 01.home/default.md +│ └── 02.Bylaws.../default.md +├── plan.knownelement.com/ +│ └── 01.home/default.md +└── ... (21 sites total) +``` + +### Cloudron State +- Git Sync pulled repo to `/app/data/user/` but synced ROOT not just `pages/` +- This wiped out accounts, admin, etc. +- Admin plugin reinstalled +- Content is in `/app/data/user/pages/` (correct location) + +## Immediate Next Steps + +1. **Create admin user:** + ```bash + su -s /bin/bash www-data -c "cd /app/code && php bin/grav newuser" + ``` + +2. **Fix Git Sync configuration** to only sync `pages/` folder: + - Check current config: `cat /app/data/user/config/plugins/git-sync.yaml` + - The `folders` setting should map repo `pages` to `user/pages` + - May need to reconfigure to prevent future wipes + +3. **Clear cache:** + ```bash + cd /app/code && php bin/grav clear-cache + ``` + +4. **Test multi-site routing:** + - Visit staticsites.turnsys.com (default site) + - Should route based on hostname to correct pages + +5. **Add domain aliases in Cloudron** for all 21 sites: + - charters.turnsys.com + - plan.afabn.org + - plan.ap4ap.org + - plan.ezeda.org + - plan.ezpodstack.org + - plan.hfnoc.net + - plan.knownelement.com + - plan.meetmorse.com + - plan.merchantsofhope.org + - plan.rackrental.net + - plan.redwfo.com + - plan.rwscp.net + - plan.sidedoorgroup.org + - plan.sol-calc.com + - plan.startinglineproductions.com + - plan.suborbital-systems.com + - plan.teamrental.net + - plan.thecampustradingcompany.com + - plan.thepeernet.com + - plan.turnsys.com + - plan.yourdreamnamehere.com + +6. **Test each domain** resolves to correct content + +--- + +## Key Files + +| File | Location | Purpose | +|------|----------|---------| +| setup.php.cloudron | `/home/charles/Projects/tsysstatic/staticsites.turnsys.com/` | Multi-site routing config for Cloudron | +| setup.php | `/app/data/user/setup.php` | Active routing config on Cloudron | +| git-sync.yaml | `/app/data/user/config/plugins/git-sync.yaml` | Git Sync plugin config | + +## Git Sync Configuration Issue + +**Problem:** Git Sync synced repo root to `/app/data/user/` instead of just `pages/` to `user/pages/` + +**Current config:** +```yaml +folders: + - pages +``` + +This should mean: sync repo's `pages/` folder to `user/pages/`. But it synced everything. + +**Need to investigate:** +- Whether Git Sync initialized in wrong location +- Whether `folders` config is correct +- May need to reinitialize Git Sync from scratch + +--- + +## Sites (21 total) + +| Site | Pages | +|------|-------| +| charters.turnsys.com | 199 | +| plan.knownelement.com | 7 | +| plan.startinglineproductions.com | 10 | +| plan.suborbital-systems.com | 2 | +| 17 other plan.* sites | 1 each | +| **Total** | 238 |