Skip to main content

​
Required Version

ArgentOS requires Node.js 22+. Use nvm to manage versions:
Do not use Homebrew Node on macOS. Native modules like better-sqlite3 are compiled against the Node ABI version at install time. Mixing Homebrew and nvm Node will cause MODULE_VERSION mismatch errors.

​
Native Module Issues

If you see NODE_MODULE_VERSION mismatch errors:

​
LaunchAgent (macOS)

The gateway LaunchAgent plist uses whatever node binary is in PATH at install time. If the plist points to Homebrew node but your modules were built against nvm node, the gateway will crash silently.
1

Fix the node path

Edit ~/Library/LaunchAgents/ai.argent.gateway.plist and ensure the node path matches your nvm version:
2

Reload the LaunchAgent