env var

N8N_REINSTALL_MISSING_PACKAGES

N8N_REINSTALL_MISSING_PACKAGES tells n8n to reinstall missing community node packages at startup, mainly as a fallback for Docker setups where package persistence is not fixed yet.

Independent third-party notes. n8n is a trademark of its owner and is referenced only for compatibility and troubleshooting context.

Quick Answer

N8N_REINSTALL_MISSING_PACKAGES tells n8n to reinstall missing community node packages at startup, mainly as a fallback for Docker setups where package persistence is not fixed yet.

Key Facts

Variable
N8N_REINSTALL_MISSING_PACKAGES
Type
Boolean
When to use
Missing community packages after container recreation or upgrade.
Better long-term fix
Persist ~/.n8n/nodes.

Recommended Steps

  1. First try to persist the ~/.n8n/nodes directory.
  2. If packages still disappear, set N8N_REINSTALL_MISSING_PACKAGES=true.
  3. Restart n8n and watch startup logs.
  4. Adjust health check timing if startup becomes slower.
  5. Return to a persistence-based fix for production stability.

Verification

  • Missing packages are reinstalled successfully.
  • The instance starts within the health check timeout.
  • Community node workflows run after startup.

Warnings

  • This option can increase startup time.
  • Slow startup can cause container health checks to fail.

Sources