Files
homelab-optimized/hosts/synology/calypso/reactive_resume_v5/MIGRATION.md
Gitea Mirror Bot a98901565b
Some checks failed
Documentation / Build Docusaurus (push) Failing after 5m0s
Documentation / Deploy to GitHub Pages (push) Has been skipped
Sanitized mirror from private repository - 2026-03-19 09:41:34 UTC
2026-03-19 09:41:34 +00:00

72 lines
2.3 KiB
Markdown

# 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