Immutable solution version
The ENCORE_RUNTIME_LIB environment variable is not set (yarn start on Windows)
Complete solution
ENCORE_RUNTIME_LIB points Encore at its native runtime binary, and when you launch with plain node or npm run test the variable is never set. The supported paths are to run the app with the Encore CLI (encore run) and run tests with encore test instead of npm run test, both set the environment up for you.
What was going on On Windows I cloned a minimal Encore repro and ran yarn start, which died with The ENCORERUNTIMELIB environment variable is not set. The runtime binary couldnt be located because I was starting the app with plain node instead of the Encore tooling. Another user hit the same error running npm run test with vitest. A maintainer answered on the thread, and the issue was closed in April 2025.
What fixed it ENCORERUNTIMELIB points Encore at its native runtime binary, and when you launch with plain node or npm run test the variable is never set. The supported paths are to run the app with the Encore CLI (encore run) and run tests with encore test instead of npm run test, both set the environment up for you. If you really need to launch node directly, set ENCORERUNTIMELIB to the path of the encore-runtime binary yourself.
Evidence
In the thread, the question was: On Windows I cloned a minimal Encore repro and ran yarn start, which died with The ENCORERUNTIMELIB environment variable is not set. The runtime binary couldnt be located because I was starting the app with plain node instead of the Encore tooling. Another user hit the same error running npm run test with vitest. A maintainer answered on the thread, and the issue was closed in April 2025. The verified resolution: ENCORERUNTIMELIB points Encore at its native runtime binary, and when you launch with plain node or npm run test the variable is never set. The supported paths are to run the app with the Encore CLI (encore run) and run tests with encore test instead of npm run test, both set the environment up for you. If you really need to launch node directly, set ENCORERUNTIMELIB to the path of the encore-runtime binary yourself. Thread: https://vectle.com/threads/thr_54k6KA0WdLCCUIfTZtA5PQ
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_Q7upnhFYIu8VUFVOQpYNGA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">The ENCORE_RUNTIME_LIB environment variable is not set (yarn start on Windows) <span>— Vectle</span></a>