When running setup.sh for Tiki Wiki 27+, you may encounter a fatal error about memory.
It is critical you try to locate the error and warning message through the continuous flow a logs that are filling your screen and look for "memory".

It may look like this for exemple

FATAL ERROR: Ineffective mark-compacts near heap limit
Allocation failed - JavaScript heap out of memory

Tiki Wiki 27 and above use modern build tools and installing the node package and compiling them require a lot more memory than running your Tiki Wiki Software and this error happenned when Node.js runs out of allocated memory on a 2Gb system during the Vite build process that compiles Tiki Wiki's JavaScript assets.

The quick Solution for Tiki Wiki Installation

Increase Node.js memory allocation before running the Tiki Wiki setup script by setting the NODE_OPTIONS environment variable:

Temporary (current session only)
Copy to clipboard
export NODE_OPTIONS="--max-old-space-size=4096"
./setup.sh

The value 4096 allocates 4GB of memory and you can adjust based on your system's available RAM.

Why This Happens in Tiki Wiki 27+

Tiki Wiki 27 and above migrated to modern JavaScript build tools (Vite) that provide better performance and development experience. However, these tools require more memory during the build process, especially when:

  • Installing from the git repository
  • Running setup.sh for the first time
  • Rebuilding after pulling updates
  • Your server has limited RAM (less than 4GB)

Tiki 27 VCS System Requirements

Before running Tiki Wiki setup, ensure your server has:

  • MySQL installed
  • PHP 8.1+
  • At least 4GB of RAM available (8GB recommended for smoother builds)
  • Node.js installed 9.0.0 <11 (check with node --version)
  • npm installed 18.0.0 <22 (check with npm --version)

Tiki 29 VCS System Requirements

Before running Tiki Wiki setup, ensure your server has:

  • MySQL installed
  • PHP 8.1+
  • At least 4GB of RAM available (8GB recommended for smoother builds)
  • Node.js installed 9.0.0 <11 (check with node --version)
  • npm installed 20.0.0 <23 (check with npm --version)

Check your available memory

Copy to clipboard
free -h

Need Help with Tiki Wiki Installation?

This is just one of many technical challenges that can arise during Tiki Wiki installation and configuration. If you're experiencing other issues with:

  • Tiki Wiki setup and deployment
  • Server configuration and optimization
  • Custom development and integrations
  • Migration from older Tiki versions

We provide professional Tiki Wiki support and consulting services. Our team has extensive experience with Tiki Wiki installations, customizations, and troubleshooting.