Prerequisites

Before you can run Jubiloop locally, make sure you have the following tools installed on your system.

Required Software

Node.js

• Version: v22.x or later (LTS version required)
• Why: Jubiloop is built with modern JavaScript/TypeScript and requires Node.js 22+ features
• Installation: Download from nodejs.org or use a version manager like nvm

npm

• Version: v10.x or later recommended
• Why: Package manager for installing dependencies across the monorepo
• Installation: Comes bundled with Node.js

Docker Desktop

• Why: We use Docker to run PostgreSQL and Redis locally without installing them directly
• Installation: Download from docker.com
• Note: You don't need PostgreSQL or Redis installed locally - Docker handles everything!

Recommended Editor

VS Code (or your preferred editor)

• Why: Code editing with excellent TypeScript support
• Installation: Download from code.visualstudio.com

Verifying Installation

After installing the prerequisites, verify everything is set up correctly:

# Check Node.js version
node --version
# Should output: v22.x.x or higher

# Check npm version
npm --version
# Should output: 10.x.x or higher

# Check Docker is running
docker --version
# Should output Docker version information

# Check Docker Compose
docker compose version
# Should output Docker Compose version information

System Requirements

• Operating System: macOS, Linux, or Windows (with WSL2)
• RAM: Minimum 8GB recommended (for running all services)
• Disk Space: At least 2GB free space

---

Next: Installation