Troubleshooting & FAQ

Common Issues & Solutions

License Verification Failed

• Ensure your IMAGERRY_LICENSE_KEY environment variable is exported or provided via --license-key.
• Verify that your machine has an active internet connection on the first run to validate the license.
• Once validated, verification is cached offline for 24 hours.

Node.js Version Incompatibility

• Imagerry CLI requires Node.js version 18.0.0 or higher.
• Run node -v in your terminal to check your current version. We recommend using Node.js 20 LTS or 22 LTS.

Native Graphics Engine Bindings

• Imagerry utilizes precompiled native C++ bindings from @napi-rs/canvas.
• If you encounter native loading issues in locked-down corporate environments, verify that your user account has execution permissions in the global node_modules directory.