# Dockge Migration Guide

Complete documentation for migrating services from photon.obnh.io to fry.obr.sh using Dockge WebUI.

## Project Overview

This repository contains comprehensive migration documentation, scripts, and verification records for moving containerized services between servers.

**Source Server:** photon.obnh.io
**Target Server:** fry.obr.sh (45.131.64.213)
**Management Tool:** Dockge WebUI
**Migration Date:** 2025-11-16

## Services to Migrate

1. **Gitea** - Git hosting service with PostgreSQL database
2. Additional services (TBD)

## Repository Structure

```
/
├── docs/                  # Migration documentation
│   ├── 01-overview.md     # Migration overview and planning
│   ├── 02-gitea-migration.md  # Gitea-specific migration steps
│   └── templates/         # Document templates
├── screenshots/           # Verification screenshots
├── docker-configs/        # Exported docker-compose.yml files
├── backups/              # Database dumps and backups
└── scripts/              # Migration automation scripts
```

## Migration Workflow

1. **Pre-Migration**
   - Service inventory and dependency mapping
   - Backup all data (databases, volumes, configs)
   - Screenshot current state in Dockge

2. **Migration**
   - Stop services on source server
   - Export docker-compose configurations
   - Transfer data to target server
   - Deploy on target server

3. **Post-Migration**
   - Verify service functionality via browser
   - DNS/routing verification
   - Documentation and commit to git

## Documentation Standards

- All timestamps in ISO 8601 format
- Screenshots required for all WebUI operations
- Browser verification via Playwright automation
- Git commits after each major step

## Author

Orchestrated by: @agent-zen-orchestrator
Executed by: Specialized sub-agents
Date: 2025-11-16