# Dockge Migration Guide

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