Table of contents
Upgrades and Versioning
Versions are computed by the pipeline, not bumped by hand. MAJOR.MINOR comes from a human-controlled git tag on main, and PATCH is the commit count since that tag. CI then injects MEMORIES_APP_VERSION into the API and image tags.
Builds and deployments run through Forgejo Actions and only on main. Scoped detection rebuilds only the services whose files changed; branch pushes run scoped tests, while nightly or manual runs exercise the full suite. The correct upgrade path is therefore to merge to main through CI, not to run manual docker operations.
Flyway migrations run automatically when the API starts. Two cautions:
- Heavy migrations, such as a large HNSW index build that can take around four to five minutes, have outlasted the 300-second deploy wait (ISSUE-065).
- Swapping to the PostGIS image for an existing volume requires a database backup first, and at least one migration fails on affected installs (ISSUE-022).
See Versioning for how versions are derived and Forgejo Deployment Pipeline for the pipeline itself. Known Issues and Operator Diagnostics tracks the migration caveats.
Details
Memories Wiki
Using Memories
- Accounts, the Library Hub, and Data Export
- Albums and Automatic Suggestions
- Explore and Discovery Domains
- The Media Viewer
- People and Faces
- Places and Map
- Plants (In Development)
- Datenschutzerklärung (Privacy Policy)
- Fast, Progressive Image Loading
- Search
- Sharing and Households
- Timeline and Photos
- Uploading and Import
Self-Hosting
- Backup and Restore
- CLI Password Reset
- Deployment Architecture
- Known Issues and Operator Diagnostics
- Map Tiles and Place Data Privacy
- Storage Layout
- Upgrades and Versioning
- Workers
Reference