This documents migrations for breaking database changes. These are intended to be as few as possible, but sometimes they are necessary.
To support 32 bit architectures, such as running Cerca on an older Raspberry Pi, the password hashing library used previously github.com/synacor/argon2id was swapped out for github.com/matthewhartstonge/argon2.
The password hashing algorithm remains the same, so users do not need to reset their password, but the old encoding format needed migrating in the database.
The new library also has a stronger default time parameter, which will be used for new passwords while old passwords will use the time parameter stored together with their database record.
For more details, see database/migrations.go.
Build and then run the migration tool in cmd/migration-tool accordingly:
cd cmd/migration-tool
go build
./migration-tool --database path-to-your-forum.db --migration 2024-01-password-hash-migration