Page:
Changelog V0.66
Pages
ADR 0001 face clustering dbscan
ADR 0001 long term domain boundaries
ADR 0002 class instance thumbnail aspect ratio
ADR 0002 v1 sharing role permission matrix
ADR 0003 v1 backup restore export guarantees
ADR 0004 v1 worker security and media access
ADR 0005 v1 import lifecycle failure recovery
ADR 0006 v1 storage backends layout integrity gc
ADR 0007 v1 worker protocol artifacts idempotency
ADR 0008 v1 deployment topology service communication
ADR 0009 v1 modular extension boundaries
ADR 0010 core owned face embedding matching
ADR 0011 immich like owner wide face recognition
ADR 0012 collaborative family group person spaces
ADR 0013 shareable forkable person identities
ADR 0014 disable clip derived visual concept labels
ADR 0015 semantic search before redesigned things
ADR 0016 detector backed things pipeline
ADR 0017 constrained density retargeting for people
ADR 0018 map tile provider boundary
ADR 0019 semantic versioning and v1 release
ADR 0020 core owned typed discovery domains
ADR 0021 time location album suggestions
ADR 0022 reverse place lookup boundary
ADR 0023 postgis for reverse place lookup
ADR 0024 operator installed country region gazetteer imports
ADR 0025 normalized place label hierarchy
ADR 0026 place provider attribution surfacing
ADR 0027 place label cache staleness and title freeze
ADR 0028 reverse lookup precision policy
ADR 0029 managed geonames install and import controls
ADR 0030 geonames import source modes
ADR 0031 defer admin uploaded geonames files
ADR 0032 postgis deployment and restore validation
ADR 0033 geonames provider mapping validation gate
ADR 0034 place label language selection
ADR 0035 automatic album clustering research gate
ADR 0036 observation producer authority
ADR 0036 owner local learned album shape proposals
ADR 0037 collaborative class instances
ADR 0038 owner local class instance governance
ADR 0039 legacy people authority retirement boundary
ADR 0040 pre live legacy people removal
ADR 0041 pre 1 0 versioning and readiness
ADR 0042 domain display terms
ADR 0043 parametrized worker capabilities
ADR 0044 people generic class occurrence
ADR 0045 progressive image component
ADR 0046 progressive media loading
ADR 0048 day bucketed dynamic loading ui
ADR 0049 two step plant discovery
ADR 0050 plant yolo threshold
ADR 0051 upgrade yolo to medium
ADR 0054 multi model abstraction layer for plant classification
ADR 0055 discovery edit mode
ADR 0056 cli password reset slim context
ADR 0093 generic class instance occurrence embeddings
ADR 0094 discovery instance representative thumbnail crop
ADR 0095 per face crops via generic discovery thumbnail job
ADR 0096 opened media is a context preserving overlay
ADR 0097 stash auto assignments are tentative and never anchors
ADR 0097 upload session operations bind to creator (user or api credential)
ADR 0098 occurrence state is the sole confirmation axis
ADR 0098 standard filter and sort menu across media walls
ADR 0099 selection mode is unified across all media walls
ADR 0100 constrained density clustering for forward face recognition
ADR 0101 single pass semi supervised face clustering
ADR 0102 tentative occurrences are movable unlabeled pool members
ADR 0103 unified quality score for suggestion ranking
ADR 0104 constrained average linkage clustering as opt in semisupervised v2
ADR 0104 face scope crop thumbnails derived by the media worker
ADR 0105 quality score c isolation absolute floor
ADR 0106 confidence aware target scoring
ADR 0107 carousel suggestions named targets
ADR 0108 multi representant person representation
ADR 0109 api read path multi representant ranking
ADR 0110 person gallery score sort reuses face thumbnails read path
ADR 0111 per user ui locale preference and localized api messages
ADR 0112 stashing a named person discards the name
ADR 0113 representative density graph
ADR 0113 representative graph validation plan
ADR 0114 representative thumbnail is manual pin or medoid of largest cluster
ADR 0115 perceptual duplicate detection via dhash
ADR 0115 standard justified media wall is mandatory for every media visualization
ADR 0116 identity aware hac validation plan
ADR 0116 identity aware hac
ADR 0117 server authoritative change feed with commit ordered sequence cursor
ADR 0118 per face age & gender estimation (genderage_v2), birth year person profiles, conservative generation gap suggestion gate
ADR 0119 anchor quality gated identity evidence
ADR 0119 ownership transfer is a db level ownership move with sender scoped satellite cleanup, not a copy
ADR 0120 person attributes manual overrides inferred gender gendered relation labels
ADR 0121 similarity suggestions rank above new person clusters
ADR 0122 real face multi medoid representatives
ADR 0123 pool emission quality gate
Accounts Library And Export
Agents
Albums
Backup And Restore
Backup Restore Export
Changelog 1.03
Changelog 1.06
Changelog 1.12
Changelog V0.66
Changelog V1.09
Changelog V1.11
Changelog V1.21.11
Changelog V1.21.12
Changelog V1.21.13
Changelog V1.21.14
Changelog V1.21.15
Changelog V1.21.16
Changelog V1.21.17
Changelog V1.21.18
Changelog V1.21.19
Changelog V1.21.20
Changelog V1.21.21
Changelog V1.21.22
Changelog V1.21.23
Changelog V1.21.24
Changelog V1.21.25
Changelog V1.21.26
Changelog V1.21.27
Changelog V1.21.3
Changelog V1.21.4
Changelog V1.21.5
Changelog V1.21.7
Changelog V1.21.75
Changelog V1.21.76
Changelog V1.21.77
Changelog V1.21.78
Changelog V1.21.79
Changelog V1.21.8
Changelog V1.21.80
Changelog V1.21.81
Changelog V1.21.82
Changelog V1.21.83
Changelog V1.21.84
Changelog V1.21.85
Changelog V1.21.86
Changelog V1.21.87
Changelog V1.21.88
Changelog V1.21.89
Changelog V1.21.9
Changelog V1.21.90
Changelog V1.21.91
Changelog V1.21.92
Changelog V1.21.93
Cli Password Reset
Deployment Architecture
Dev Agent Workflow
Dev Cli Password Reset
Dev Forgejo Deployment Pipeline
Dev Model Selection Report
Dev Playwright Mock Fixtures
Dev Versioning
Explore Discovery Domains
Home
Known Issues And Diagnostics
Known Issues
Map Tiles And Places Privacy
Media Viewer Overlay
Operator Cast Requirements
Operator People Generic Consistency
Operator Play Publishing Runbook
Operator Play Review Instance
People And Faces
Places And Map
Plants
Privacy Policy
Progressive Image Loading
Readme
Search
Sharing And Households
Storage Layout
Timeline And Photos
Upgrades And Versioning
Uploading And Import
Vision
Workers
No results
Table of contents
- v0.66
- Highlights
- Full i18n of the web app — EN / DE / DA (spec 058, ADR 0111)
- Place search & map UX
- Person representation & face recognition
- People domain on the generic discovery pipeline (specs 033–037)
- Media browsing, search & upload
- Android app (separate android-v* version series — not part of this tag)
- Admin & operations
- Performance
- Internal / notable fixes
- Operator notes
- Follow-ups
This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
v0.66
Date: 2026-10-13
Range: v0.65 (2026-06-22, 4366894d) → main (4155be00) — 2,022 commits.
Server version and image tags are derived from the v0.66 git tag by
scripts/ci/compute-version.sh; no version files are bumped for this release.
Highlights
Full i18n of the web app — EN / DE / DA (spec 058, ADR 0111)
- Paraglide v2 infrastructure:
en/de/damessage catalogs, cookie locale, app-chrome extraction (#1178). - Per-account language preference: stored per user (V162), applied at session load, plus localized API
ProblemDetails(#1180, #1181). - Extraction waves 2–5 moved every Svelte surface onto message keys: discovery/suggestions/albums/search (#1183), map/people/media/upload/sharing (#1186), admin/library/processing/backup/shared (#1185), final sweep (#1197) — ~2,163 keys per locale.
- Polished language switcher in the top bar (#1184) and a committed-baseline hardcoded-string guard test that fails CI on new literal UI copy (#1197).
Place search & map UX
- Local gazetteer forward place-search API (#1190) plus place-search autocomplete in the shared topbar input that flies the map (#1192); backed by a trigram index (V163).
- Map responsiveness and layout: O(n²) → spatial-grid viewport clustering (#1157), cluster-tap zoom as one decelerating motion (#1156), tablet split layout with photos beside the map (#1189), Karte/Satellit layer toggle (#1105, #1107, ADR 0018).
- Android map parity: clustered viewport with scope chips (#1126), zoom-to-fit + photo markers (#1151), media sidebar (#1177), split-view marker taps zoom and filter again (#1195).
Person representation & face recognition
- Multi-representant person representation (CV-validated) drives assignment ranking (#1080, #1081, #1083; ADR 0109); confidence-aware (LCB) scoring for ranking, merge suggestions and target pickers (#1070, #1071).
- pgvector-native embeddings with HNSW kNN for person ranking (spec 043, #826) — needs the new PostGIS+pgvector image below.
- Clustering rebuilt: semisupervised-v1 single-pass A/B/C lifecycle (#996, ADR 0101) and opt-in semisupervised-v2 constrained average-linkage (#1035, ADR 0104), with a clustering-method registry plus owner self-service reset/recluster (#982–#985).
- Review workflow: stash-away/disband semantics (#766, #767, #771), tentative occurrence state as the sole confirmation axis (spec 048, #893, #894, #896), subset merge/confirm selections (#1006, #1007), weak single-face matches gated by kNN consensus (#772, #822).
- Face UI: scope-crop thumbnails (#1059), carousel face zoom with per-face
boundingBox(#1046, #1053, #1054), person embedding "Kort" map (#816, #817), manual face bbox drawing/editing/delete (#1161, #1164, #1169). - Self person: claim + profile photo endpoints, crop dialog and "Ich" badge (spec 057, #1149, #1150, #1158).
People domain on the generic discovery pipeline (specs 033–037)
face_embeddings→class_occurrence_embeddings(V101),face_annotationsabsorbed intodiscovery_results,PeopleControllerretired in favour of/api/discovery, generic instance/merge suggestions (#636), collaborative class instances (#535), domain-keyed automation runs (#565).- Explore loops discovery domains generically instead of hard-coded People+Plants; plants get bbox-cropped thumbnails (#506–#510).
Media browsing, search & upload
- "On this day" carousel on the Photos start page (spec 056, #1137, #1138) with compact cards and full-day modal (#1148, #1165, #1167).
- Search filter tokens and dropdowns: year/date-range, album, favorite,
person:,face:detected,face:unassigned, approval (#843–#849, #1108, #1136, #1176). - Cross-device upload activity with SSE + batch-completion notifications (#801, #924, #925), constant-denominator X/Y progress (#936), targeted
thumbnails_readySSE (#948, #949), manual discard of interrupted uploads (#955). - Standard filter/sort menus and unified selection mode across every media wall (ADR 0098/0099, #914, #922, #926); titles-first progressive timeline hydration (spec 051, #1000, #1012).
- Owner metadata overrides — capture date/location edits with effective values and revert (FR-041/SC-019, #1095, #1096).
Android app (separate android-v* version series — not part of this tag)
- Backup-first MVP → 0.5.2: day-sectioned timeline (#1118), albums (#1121), search (#1119), people (#1123), map (#1126), viewer actions (#1116), upload activity + manual picker upload (#1127), minSdk lowered to 25 (#1125), stable debug keystore so updates install over CI builds (#1152).
Admin & operations
- Unified admin log terminal with job-events feed, tailing and error details (#878, #879, #986); processing summary exposes operations (uploads + reprocess runs) (#973, #974).
- API key management — list/revoke endpoints + profile UI (#605, #606) and CLI password reset with audit + session invalidation (#704).
Performance
- Map viewport clustering replaced by a spatial grid (#1157); timeline days list no longer runs a correlated lateral subquery (#1009).
- Candidate-overlap + batched confirm removes per-decision N+1: 890 face queries → 2 (#821); ranking candidate-face lookups batched (#1089).
- Recognition-run pipeline latency + carousel gate rework (#1040); batched face-embedding inference into a single ONNX call (#623).
- Measured indexes for processing-summary, person-filter search and library-stats paths (V100, V137; #514, #842); optimistic tentative decisions with no full-refetch wait (#820).
Internal / notable fixes
- JDBC stream leak causing connection-pool exhaustion (#615); embedding null-parameter SQL incident with post-mortem + RCA (#611–#614).
- API startup regressions fixed: Spring constructor ambiguity (#1140), multi-constructor autowiring hotfixes (#1113, #1115), Jackson
maxStringLengthfor large clustering results (#992). - Flyway version collisions resolved before/after deploy: V097→V101 (#552), out-of-order allowance (#569), V139→V140 (#881), V161→V162 renumber.
- People worker stability: HEIC decode via pillow-heif (#945), EXIF orientation applied before detection (#942), ONNX/BLAS thread caps (#721), blockwise density graph fixing an OOM segfault at 26k faces (#975), arcface-r50 embedding-space backfill (#763).
- Upload/session hardening: session ownership enforced (#869), duplicate
upload_session_filestolerated (#943), media filename URL-decoding and capture-year bounds (#1028). - Timeline scroll stability across SSE refreshes and deep axis jumps (#895, #939); toast overlay cleared of the mobile bottom nav (#1130).
- CI/test: scoped PR tests moved to the winterfell runner (#957), deterministic Playwright suite with capped workers (#904, #1069), 24 pre-existing E2E failures resolved before i18n merge (#1182).
Operator notes
Database migrations — 68 new since v0.65
- 68 new Flyway files: V095–V096, V098–V163 (no V097 — it was created then renumbered to V101 during deploy fixes). Latest is V163
place_search_name_trgm_index; the per-user locale column is V162user_account_locale. - Most notable: V101
class_occurrence_embeddings(embedding-space migration), V115clear_person_domain(people-domain reset during the generic-pipeline migration), V136 pgvector embedding column, V141/V142 tentative occurrence state, V148 domain reprocess runs, V156 person representatives, V159 self persons, V161 domain singular display names, V162 locale, V163 place-search trigram index.
Deploy / infrastructure
- Postgres image changed:
postgis/postgis:16-3.4-alpine→ self-builtmemories-postgresfromdeploy/postgres/Dockerfileadding pgvector (spec 043). Samememories-postgres-datavolume — container recreate only; first boot builds the HNSW index (ISSUE-065 healthcheck note). - Storage layout (spec 054): compose now bind-mounts one stable
/srv(rslave propagation) into every service.MEMORIES_LIBRARY_PATH,MEMORIES_STORED_OBJECTS_PATH,MEMORIES_DERIVED_PATH,MEMORIES_UPLOAD_STAGING_PATH,MEMORIES_EXPORTS_PATH,MEMORIES_QUARANTINE_PATH,MEMORIES_GEONAMES_DOWNLOADS_PATHare removed fromdeploy/compose.yamlanddeploy/example.env— the seven paths are configured in the database via the Admin UI. Existing installs must keep data reachable under/srv(docs/deploy-srv.md,scripts/setup-srv-mounts.sh). - Worker capability changes: media worker gains
generate_plant_thumbnail,generate_discovery_thumbnail,generate_face_scope_thumbnail,profile_photo_crop; ML worker dropsface_detection/owner_face_recognition(they live on the people worker); people worker gainsowner_face_embedding_backfill+ pinned BLAS/ONNX thread caps; plants worker gainsmodel_download. The media worker token now comes fromMEMORIES_WORKER_TOKEN_ML. - No new compose services — no new workers to provision.
- CI: container registry moved from the NAS to Forgejo (
git.wiwie.dk, #1091); two new workflows —android-release.yml(versionedandroid-v*Forgejo releases, #1187) andwiki-sync.yml(#857).
Follow-ups
- ISSUE-151 (
low,open): two multi-part template-literalconfirm()strings escaped the spec 058 waves and the guard's single-literal scanner — trash confirm on/and the decision-history revert confirm. Needs a micro-pass plus a guard blind-spot fix. - ISSUE-148 / ISSUE-149 (
low,open): two load-dependent E2E flakes (backup-export safe-mode click, discovery merge menu) that pass on retry.
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