Disable Hyper‐V in Windows

Need for AVX

SF uses MongoDB. MongoDB requires AVX in the CPU.

If AVX is not enabled, or perhaps also by other CPU-level requirements not being met, then you may 1 2 see

$ mongod --version
Illegal instruction

or

$ systemctl status mongod.service
...
code=killed, signal=4/ILL

Running SF may produce output such as

$ dotnet run
... web-xforge/src/SIL.XForge.Scripture/bin/Debug/net8.0/RealtimeServer/node_modules/mongodb/lib/sdam/topology.js:292
                const timeoutError = new error_1.MongoServerSelectionError(`Server selection timed out after ${serverSelectionTimeoutMS} ms`, this.description);
                                     ^
MongoServerSelectionError: connect ECONNREFUSED 127.0.0.1:27017
    at Timeout._onTimeout

You can check if AVX is enabled by running the following in a virtual guest or on your host.

lscpu | grep avx

If available, it should give a Flags: line with a number of items, including "avx" and "avx2". If not available, there will be no output.

Enabling AVX

It could be that you need to enable AVX in your computer's BIOS.

In Windows, Hyper-V can interfere with AVX in VirtualBox. To disable Hyper-V in the host Windows machine, you can run the following in an elevated command prompt and then reboot your host.

bcdedit /set hypervisorlaunchtype off