dockge-migration-guide/docs/02-gitea-migration.md

Gitea Migration - Detailed Execution Log

Service: Gitea (Git hosting) Started: 2025-11-16T10:30:00Z Status: In Progress

Pre-Migration Checklist

• Dockge WebUI accessible on photon.obnh.io
• Both containers (gitea + gitea_postgres) visible
• Screenshots captured
• Database backup created
• Backup verified and transferred

Step 1: Pre-Migration Backup

Actions Required

1. Access photon.obnh.io Dockge WebUI
2. Identify gitea_postgres container
3. Execute pg_dump command
4. Save backup to /home/olaf/dockge-migration-guide/backups/
5. Verify backup file integrity

Commands

# Database dump (to be executed on photon)
docker exec gitea_postgres pg_dump -U gitea gitea > gitea_db_backup_$(date +%Y%m%d_%H%M%S).sql

# Verify backup
ls -lh gitea_db_backup_*.sql

Evidence

• Screenshot: screenshots/01-photon-dockge-containers.png
• Backup file: backups/gitea_db_backup_TIMESTAMP.sql

---

Step 2: Screenshot Documentation

Dockge Container View

• Screenshot showing both gitea containers
• Container status visible (running/stopped)
• File: screenshots/01-photon-dockge-containers.png

---

Step 3: Stop Gitea Service

Procedure

1. Navigate to Dockge WebUI on photon
2. Stop gitea container (application first)
3. Screenshot the stop action
4. Stop gitea_postgres container (database second)
5. Screenshot the stop action
6. Verify both containers stopped

Evidence

• Screenshot: screenshots/02-stop-gitea-container.png
• Screenshot: screenshots/03-stop-postgres-container.png
• Screenshot: screenshots/04-both-containers-stopped.png

---

Step 4: Export Docker Compose Configuration

Actions

1. Open Dockge WebUI on photon
2. Navigate to Gitea stack
3. Copy entire docker-compose.yml content
4. Save to docker-configs/gitea-compose-photon.yml
5. Screenshot the configuration view

Evidence

• Config file: docker-configs/gitea-compose-photon.yml
• Screenshot: screenshots/05-docker-compose-export.png

---

Step 5: Database Transfer

Actions

1. Transfer database dump to fry.obr.sh
2. Verify file integrity (checksum)
3. Prepare for restore

Commands

# Transfer to fry
scp gitea_db_backup_*.sql root@fry.obr.sh:/tmp/

# Verify on fry
ssh root@fry.obr.sh "md5sum /tmp/gitea_db_backup_*.sql"

---

Step 6: Deploy on Fry

Procedure

1. Access Dockge WebUI on fry.obr.sh
2. Create new stack named "gitea"
3. Paste docker-compose.yml content
4. Start postgres container first
5. Restore database
6. Start gitea container
7. Screenshot each step

Database Restore

# Restore database (execute on fry)
docker exec -i gitea_postgres psql -U gitea gitea < /tmp/gitea_db_backup_*.sql

Evidence

• Screenshot: screenshots/06-fry-dockge-new-stack.png
• Screenshot: screenshots/07-fry-compose-paste.png
• Screenshot: screenshots/08-fry-postgres-started.png
• Screenshot: screenshots/09-fry-gitea-started.png

---

Step 7: Browser Verification

Playwright Automation

• Navigate to git.photon.obnh.io (should resolve to fry)
• Verify login page loads
• Test repository browsing
• Screenshot successful access

Verification Points

1. DNS resolution (should point to 45.131.64.213)
2. HTTPS certificate valid
3. Login page renders
4. Repository list accessible
5. Git operations functional

Evidence

• Screenshot: screenshots/10-browser-login-page.png
• Screenshot: screenshots/11-browser-repo-list.png

---

Step 8: Final Verification

Checklist

• Gitea accessible via browser
• All repositories visible
• User authentication working
• Git clone/push operations tested
• DNS routing verified

---

Post-Migration

Actions

• Commit all screenshots to git
• Update this document with timestamps
• Tag git commit: gitea-migration-complete
• Archive backups

Rollback Procedure (if needed)

1. Stop containers on fry
2. Restart containers on photon
3. Verify service restoration
4. Document incident

---

Timeline

Step	Started	Completed	Duration	Status
Pre-Migration Backup				Pending
Screenshot Documentation				Pending
Stop Gitea Service				Pending
Export Configuration				Pending
Database Transfer				Pending
Deploy on Fry				Pending
Browser Verification				Pending
Git Commit				Pending

---

Notes

This document will be updated in real-time as the migration progresses.