Troubleshooting

Learn how to troubleshoot common issues with your Nuxt Starter Kit application.

I encounter a JavaScript heap out of memory error while trying to deploy to NuxtHub

The FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory error occurs when the Node.js process runs out of memory. Probably related to this issue.

You can increase the memory limit by setting the NODE_OPTIONS environment variable to --max-old-space-size=8192 (or a higher value) before running the deployment command.

This is automatically done in the NuxtHub deployment process via GitHub action, so you don't need to worry about it. See nuxthub.yml for more details.