Pictaria Server v1.2.1 fixes Smart Album pagination on older Immich versions and improves hierarchical tag synchronization with Immich 3.2.
Fixes
- Smart Albums on Immich before 3.1: complete date-window reads avoid photos being omitted or repeated at unstable page boundaries. Matching, exclusions and album membership use the compatibility reader, with an independent count check and one bounded retry. If exclusions or membership cannot be verified, the album stays unchanged. Immich 3.1+ keeps ordinary pagination.
- Enrich and Curate tag sync: an incomplete successful tag-creation response now triggers one tag-list refresh to resolve missing IDs. This avoids a fallback incompatible with hierarchical tags on Immich 3.2. Unresolved tags remain visible errors handled by the existing retry queues.
- Documentation: guidance now covers managed tags and Immich workflows, API-key rotation and inventory refresh, and person filters after an optional recognition reset.
Upgrade
Back up Pictaria, then follow the v1.2.1 upgrade guide. Use the tagged Compose file and matching image:
ghcr.io/pictaria-ai/pictaria-server:1.2.1
From v1.2.0, no new persisted-state migration occurs: contract 15, Enrich schema 12 and settings version 7 are unchanged. If no other migration occurred, you can stop the server and return to v1.2.0 without restoring data. Switching code does not undo writes already made to Immich.
From v1.0.x or v1.1.0, direct upgrade is supported, but the v1.2 data migrations still run. Retain the complete pre-migration snapshot and matching older build for rollback.
The older-Immich Smart Album reader requires asset.statistics in addition to the existing asset/tag read permissions. After updating, run an affected Smart Album and check membership. Existing pending tag writes can use Retry sync without another inference run.
Node requirements, the Pictaria Frame protocol and the Immich 2.0+ compatibility floor are unchanged. No Immich or Frame upgrade is required.
Validation
All 1,187 automated tests pass, alongside container build/boot, upgrade compatibility, publication hygiene and DCO checks. The fixes received independent review. Targeted user-reported live checks passed against Immich 2.7.5, 3.1 and 3.2, including Smart Album additions/removals and Enrich/Curate tag writes. Broader Server/Frame 3.2 compatibility testing remains separate.
See the full changelog.
Published image
Source commit: 29a7d312f70767eba36bc70b9391a3bbe67b5488.
Verified multi-platform image (linux/amd64 and linux/arm64):
ghcr.io/pictaria-ai/pictaria-server@sha256:ab24656436246500d457c7155c3b1a6b2001b9cfbaa69ef0e3ef79aea83f8729
The 1.2.1 and latest tags resolve to this same manifest. Both platform images identify the source commit above and version 1.2.1. Publication checks passed.