homelab-optimized/hosts/synology/calypso/reactive_resume_v5/MIGRATION.md

Migration from Reactive Resume v4 to v5

Migration Summary

Successfully migrated from Reactive Resume v4 to v5 on 2026-02-16.

Port Configuration

• Main Application: Port 9751 (same as v4)
• S3 API: Port 9753 (same as v4 MinIO)
• PDF Service: Port 4000 (internal)

Reverse Proxy Compatibility

The migration maintains the same external ports, so existing reverse proxy rules continue to work:

• http://192.168.0.250:9751 → rx.vish.gg
• http://192.168.0.250:9753 → rxdl.vish.gg (S3 API)

Changes from v4 to v5

Storage Backend

• v4: MinIO for S3-compatible storage
• v5: SeaweedFS for S3-compatible storage
• Same S3 API compatibility on port 9753

Database

• v4: PostgreSQL 16
• v5: PostgreSQL 18
• Database migration handled automatically

PDF Generation

• v4: Browserless Chrome with HTTP API
• v5: Browserless Chrome with WebSocket API
• Better performance and real-time updates

Authentication

• v4: Custom auth system
• v5: Better Auth framework
• More secure and feature-rich

Data Migration

• Database data preserved in /volume1/docker/rxv5/db/
• File storage migrated to SeaweedFS format
• User accounts and resumes preserved

Removed Services

The following v4 containers were stopped and removed:

• Resume-ACCESS (v4 main app)
• Resume-DB (v4 database)
• Resume-PRINTER (v4 PDF service)
• Resume-MINIO (v4 storage)

New Services

The following v5 containers are now running:

• Resume-ACCESS-V5 (v5 main app)
• Resume-DB-V5 (v5 database)
• Resume-BROWSERLESS-V5 (v5 PDF service)
• Resume-SEAWEEDFS-V5 (v5 storage)
• Resume-BUCKET-V5 (storage initialization)

Configuration Files

• v4 configuration archived to: /home/homelab/organized/repos/homelab/archive/reactive_resume_v4_archived/
• v5 configuration active in: /home/homelab/organized/repos/homelab/Calypso/reactive_resume_v5/

Verification

• ✅ Application accessible at http://calypso.vish.local:9751
• ✅ S3 API accessible at http://calypso.vish.local:9753
• ✅ All containers healthy and running
• ✅ Reverse proxy rules unchanged
• ✅ Account creation working (no more "Invalid origin" errors)

Future Enhancements

• Ollama AI integration (when v5 supports it)
• External domain configuration for https://rx.vish.gg
• Automated backups of SeaweedFS data