nixpkgs/nixos/modules/services/web-apps/immich.md
Sefa Eyeoglu a9c17c34b1
nixos/immich: add VectorChord migration docs
Signed-off-by: Sefa Eyeoglu <contact@scrumplex.net>
2025-08-19 17:56:20 +02:00

1.5 KiB

Immich

Immich is a self-hosted photo and video management solution, similar to SaaS offerings like Google Photos.

Migrating from pgvecto-rs to VectorChord (pre-25.11 installations)

Immich instances that were setup before 25.11 (as in system.stateVersion = 25.11;) will be automatically migrated to VectorChord. Note that this migration is not reversible, so database dumps should be created if desired.

See Immich documentation for more details about the automatic migration.

After a successful migration, pgvecto-rs should be removed from the database installation, unless other applications depend on it.

  1. Make sure VectorChord is enabled () and Immich has completed the migration. Refer to the Immich documentation for details.

  2. Run the following two statements in the PostgreSQL database using a superuser role in Immich's database.

    DROP EXTENSION vectors;
    DROP SCHEMA vectors;
    
    • You may use the following command to run these statements against the database: sudo -u postgres psql immich (Replace immich with the value of )
  3. Disable pgvecto-rs by setting to false.

  4. Rebuild and switch.