Files

olaf 6bbbb65238 Initial migration guide structure

- Created repository layout (docs, screenshots, backups, docker-configs)
- Added comprehensive README with project overview
- Created 01-overview.md with migration strategy
- Created 02-gitea-migration.md execution template
- Defined success criteria and risk mitigation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-11-16 10:39:49 +00:00

2.3 KiB

Raw Permalink Blame History

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

Backup-First Approach
- Full PostgreSQL dump before any changes
- Volume snapshots where applicable
- Verify backup integrity
Graceful Shutdown
- Stop application container first
- Stop database container second
- Verify all processes stopped
Data Transfer
- Secure transfer of database dumps
- Transfer docker-compose configuration
- Preserve volume data
Staged Deployment
- Deploy database container first
- Restore database from dump
- Deploy application container
- Verify connectivity
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 for detailed execution steps.

2.3 KiB Raw Permalink Blame History