Upgrade central cannot find module error

Support
1

1. What is the issue? Please be detailed.

I am using a self-hosted ODK Central with the following version

versions:
279c4cb68c14854efb3ca41164451cae33f4fa7d (v2024.3.1-2-g279c4cb)
 454ade29b5ee001da94c59ef07aa873359193384 client (v2024.3.1)
 7574030f7ea8750f3837950001a5efcdeba45b92 server (v2024.3.1)

I am trying to upgrade to the latest version beginning with v2025.3. I have followed the steps outlined here. And when I restarted docker

docker compose stop && docker compose up -d

I have the following error when looking at the logs

service-1  | Error: Cannot find module '/usr/odk/lib/bin/log-upgrade'
service-1  |     at Function._resolveFilename (node:internal/modules/cjs/loader:1383:15)
service-1  |     at defaultResolveImpl (node:internal/modules/cjs/loader:1025:19)
service-1  |     at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1030:22)
service-1  |     at Function._load (node:internal/modules/cjs/loader:1192:37)
service-1  |     at TracingChannel.traceSync (node:diagnostics_channel:328:14)
service-1  |     at wrapModuleLoad (node:internal/modules/cjs/loader:237:24)
service-1  |     at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:171:5)
service-1  |     at node:internal/main/run_main_module:36:49 {
service-1  |   code: 'MODULE_NOT_FOUND',
service-1  |   requireStack: []
service-1  | }

2. What steps can we take to reproduce this issue?

First, Install v2024.3 ODK Central.

Second, follow the upgrade steps such as git module -i, docker compose pull && docker compose build --pull, docker compose stop && docker compose up -d.

Finally, check the logs for the service.

3. What have you tried to fix the issue?

4. Upload any forms or screenshots you can share publicly below.

2

You could try following the recommendation from ODK Central database migration incomplete - #2 by Matthew_White which was for a similar “Cannot find module” error.

In your post you say you ran git module -i but the documentation says to run git submodule update -i. Was your post a typo or did you run the wrong command?