# Migration Overview

**Document Version:** 1.0
**Created:** 2025-11-16T10:30:00Z
**Last Updated:** 2025-11-16T10:30:00Z

## Objective

Migrate Gitea service from photon.obnh.io to fry.obr.sh with zero data loss and minimal downtime.

## Infrastructure Details

### Source Server: photon.obnh.io
- **Role:** Legacy container host
- **Management:** Dockge WebUI
- **Services:** Gitea (gitea + gitea_postgres containers)

### Target Server: fry.obr.sh
- **IP:** 45.131.64.213
- **Role:** New container host
- **Management:** Dockge WebUI
- **Status:** Ready for deployment

## Critical Components

### Gitea Service
- **Container 1:** gitea (application)
- **Container 2:** gitea_postgres (database)
- **Database:** PostgreSQL with critical repository data
- **Volumes:** Git repository data, configs, database files

## Migration Strategy

1. **Backup-First Approach**
   - Full PostgreSQL dump before any changes
   - Volume snapshots where applicable
   - Verify backup integrity

2. **Graceful Shutdown**
   - Stop application container first
   - Stop database container second
   - Verify all processes stopped

3. **Data Transfer**
   - Secure transfer of database dumps
   - Transfer docker-compose configuration
   - Preserve volume data

4. **Staged Deployment**
   - Deploy database container first
   - Restore database from dump
   - Deploy application container
   - Verify connectivity

5. **Verification**
   - Browser-based functional testing
   - DNS resolution verification
   - Repository access testing

## Risk Mitigation

- **Database Corruption:** Full pg_dump before migration
- **Network Issues:** Local backups retained on source
- **Configuration Drift:** Exact docker-compose.yml export
- **Service Downtime:** Documented rollback procedure

## Success Criteria

- [ ] Gitea accessible via browser on fry.obr.sh
- [ ] All repositories intact and browsable
- [ ] User authentication functional
- [ ] Database queries responding correctly
- [ ] DNS routing verified (if applicable)
- [ ] All documentation committed to git

## Timeline

- **Preparation:** 30 minutes
- **Backup:** 15 minutes
- **Migration:** 45 minutes
- **Verification:** 30 minutes
- **Total:** ~2 hours

## Next Steps

Proceed to [02-gitea-migration.md](./02-gitea-migration.md) for detailed execution steps.