CPU Compatibility
- Check the release
Confirm the binary matches the host platform.
- Check the host
Inspect the reported CPU or instruction error.
- Get help
Send the exact error and platform details.
You can confirm compatibility or give support the information needed to diagnose startup.
Next: System requirements
The distribution binary is built for compatibility mode, so it runs on a wide range of x64 and ARM64 CPUs. On very old hardware or restricted environments, you may see errors like:
Illegal instructionSIGILLOperation not supported(when the binary hits an unsupported CPU instruction)
What to do
Section titled “What to do”-
Verify the binary — run
./identity-scribe-* --version. If this fails, the CPU may not support the baseline instructions required by the compatibility build. -
Check your CPU — the compatibility target excludes newer instruction sets (e.g. AVX2, AVX-512). If you run on an older x64 CPU (pre-2011) or a constrained VM/container, you may hit limits.
-
Workarounds:
- Run on a host that meets the System requirements.
- Make sure you run the binary that matches your target platform/architecture (for example, x64 vs ARM64).
- If startup still fails, contact support and include the exact error output plus your platform details (
uname -m, container base image, and virtualization environment).