Initialize migration documentation structure

- Create comprehensive README with migration overview
- Add MIGRATION_STATUS.md for progress tracking
- Set up directory structure for screenshots, docs, verification
- Document migration methodology and requirements

Generated with AI orchestration

MIGRATION_STATUS.md

@@ -0,0 +1,74 @@
+# Migration Status Tracker
+
+**Last Updated:** 2025-11-16 10:30 UTC
+
+## Overview
+
+| Service | Status | Started | Completed | Notes |
+|---------|--------|---------|-----------|-------|
+| Traefik | ⏳ Pending | - | - | CRITICAL: Must complete first |
+| photon-default-page | ⏳ Pending | - | - | Waiting for Traefik |
+| Gitea | ⏳ Pending | - | - | Includes PostgreSQL database |
+| Mastodon (bern.social) | ⏳ Pending | - | - | 5 containers, most complex |
+
+## Status Legend
+- ⏳ **Pending** - Not started
+- 🔄 **In Progress** - Currently migrating
+- ✅ **Completed** - Successfully migrated and verified
+- ⚠️ **Issues** - Problems encountered
+- ❌ **Failed** - Migration failed, needs intervention
+
+## Current Phase
+
+**Phase:** Repository setup and initial planning
+**Current Task:** Creating documentation structure
+**Next Task:** Initialize Dockge WebUI on both servers
+
+## Pre-Migration Checks
+
+- [x] Git repository created on git.proton.obr.sh
+- [x] Documentation structure initialized
+- [ ] Dockge WebUI configured on photon.obnh.io
+- [ ] Dockge WebUI configured on fry.obr.sh
+- [ ] Screenshot tooling verified
+- [ ] OpenRouter.AI image analysis tested
+- [ ] Browser verification tools tested
+
+## Server Status
+
+### Source: photon.obnh.io (95.217.133.54)
+**Running Services:**
+- Dockge (port 5001) - ⚠️ Needs initial setup
+- Traefik - ✅ Running
+- Mastodon (5 containers) - ✅ Running
+- Gitea + PostgreSQL - ✅ Running
+- photon-default-page - ✅ Running
+
+### Target: fry.obr.sh (45.131.64.213)
+**Running Services:**
+- Dockge (port 5001) - ⚠️ Needs initial setup
+- Traefik - ✅ Running (already deployed)
+- test-whoami - ✅ Running (test service)
+
+## Migration Timeline
+
+| Date | Event |
+|------|-------|
+| 2025-11-16 10:30 | Repository created |
+| 2025-11-16 10:30 | Documentation structure initialized |
+
+## Blockers & Issues
+
+None currently.
+
+## Notes
+
+- Traefik is already partially deployed on fry.obr.sh
+- Both Dockge instances require initial setup before WebUI can be used
+- All compose files located in /opt/ on photon.obnh.io
+- Backup system already in place (restic to Hetzner)
+
+---
+
+**Migration Coordinator:** AI-orchestrated multi-agent system
+**Documentation:** Auto-generated with screenshot annotations

README.md

@@ -1,3 +1,115 @@
-# dockge-migration-guide
+# Dockge Migration Guide
 
-Complete guide for migrating services from photon.obnh.io to fry.obr.sh using Dockge WebUI with screenshot documentation
+Complete step-by-step guide for migrating all services from **photon.obnh.io** to **fry.obr.sh** using Dockge WebUI with comprehensive screenshot documentation.
+
+## Migration Overview
+
+**Source Server:** photon.obnh.io (95.217.133.54)
+**Target Server:** fry.obr.sh (45.131.64.213)
+**Method:** Docker Compose migration with Dockge WebUI management
+**Documentation:** AI-annotated screenshots at every step
+
+## Services to Migrate
+
+Migration follows strict dependency order:
+
+1. **[Traefik](docs/01-traefik-migration.md)** - CRITICAL FIRST (reverse proxy)
+2. **[photon-default-page](docs/02-photon-default-page-migration.md)** - Simple test service
+3. **[Gitea](docs/03-gitea-migration.md)** - Git hosting + PostgreSQL database
+4. **[Mastodon (bern.social)](docs/04-mastodon-migration.md)** - Complex (5 containers)
+
+## Repository Structure
+
+```
+/
+├── README.md                          # This file
+├── docs/                              # Step-by-step migration guides
+│   ├── 01-traefik-migration.md
+│   ├── 02-photon-default-page-migration.md
+│   ├── 03-gitea-migration.md
+│   ├── 04-mastodon-migration.md
+│   └── 99-troubleshooting.md
+├── screenshots/                       # All screenshots
+│   ├── original/                      # Original unmodified screenshots
+│   └── annotated/                     # AI-annotated with markup
+├── compose-files/                     # Docker compose configurations
+├── verification/                      # Browser verification results
+└── MIGRATION_STATUS.md                # Current migration progress
+```
+
+## Migration Methodology
+
+### Pre-Migration Checklist
+- [ ] Backup all data on source server
+- [ ] Verify DNS records
+- [ ] Test SSH access to both servers
+- [ ] Verify Dockge running on both servers
+- [ ] Document current service status
+
+### Migration Steps (Per Service)
+1. **Screenshot & Document** - Capture current state in Dockge WebUI
+2. **Stop Service** - Gracefully stop on source server
+3. **Export Configuration** - Copy docker-compose.yml and environment
+4. **Transfer Data** - Migrate volumes, databases, persistent data
+5. **Deploy on Target** - Apply configuration on fry.obr.sh
+6. **Verify Running** - Check service health in Dockge
+7. **Browser Verification** - Test via automated browser checks
+8. **Update DNS** - Point domain to new server (when ready)
+
+### Screenshot Documentation
+- **Tool:** Playwright browser automation
+- **AI Analysis:** google/gemini-2.5-flash-image via openrouter.ai
+- **Annotations:** Arrows, circles, labels showing exact actions
+- **Storage:** Both original and annotated versions in git
+
+### Verification Requirements
+Each migrated service must pass:
+- HTTP 200 OK response
+- Correct response headers (fry.obr.sh IP: 45.131.64.213)
+- Service-specific health checks
+- Browser screenshot proof
+
+## Current Status
+
+See [MIGRATION_STATUS.md](MIGRATION_STATUS.md) for real-time progress tracking.
+
+## Tools & Technologies
+
+- **Dockge:** WebUI for Docker Compose management (port 5001)
+- **Docker Compose:** Container orchestration
+- **Traefik:** Reverse proxy and SSL termination
+- **Playwright:** Browser automation for verification
+- **OpenRouter.AI:** Image analysis with Gemini 2.5 Flash
+- **Gitea:** Documentation repository hosting
+
+## Important Notes
+
+⚠️ **Migration Order is Critical**
+Traefik MUST be migrated first as it provides reverse proxy for all other services.
+
+⚠️ **Downtime Expectations**
+Each service will have brief downtime during migration. Plan accordingly.
+
+⚠️ **DNS Propagation**
+DNS changes can take 5-60 minutes to propagate globally.
+
+⚠️ **Backup First**
+All services have been backed up before migration begins.
+
+## Support & Troubleshooting
+
+See [docs/99-troubleshooting.md](docs/99-troubleshooting.md) for common issues and solutions.
+
+## Generated Documentation
+
+This guide was created using AI-assisted migration orchestration with:
+- Multi-agent coordination for complex tasks
+- Automated screenshot capture and analysis
+- Browser-based verification
+- Real-time documentation generation
+
+---
+
+**Migration Start Date:** 2025-11-16
+**Estimated Completion:** TBD
+**Repository:** https://git.proton.obr.sh/olaf/dockge-migration-guide