Installation

iProTraX can be deployed using standard Node.js for flexibility or Docker for production reliability. We recommend Docker for most shop floor deployments.

System Prerequisites

  • Node.js 20.9+ (for standard)
  • Docker & Compose (for container)
  • OpenAI / Ollama (for AI)
  • SQLite (No install needed)

Method 1: Standard Node.js

Ideal for local development or running on bare-metal Mac Mini / Windows servers.

1

Install Dependencies

npm install
2

Configure Environment

Create a .env file in the root directory.

OPENAI_API_KEY=sk-your-api-key-here
# Optional: Unlock Pro/Enterprise features
LICENSE_KEY=your-license-key
ℹ️ Note:Without a LICENSE_KEY, the system runs in "Free Tier" (1 Line, 10 Users) forever.
3

Setup Database

npx prisma generate
npx prisma db push
4

Start Server

npm run dev  # Development
npm start    # Production

Method 2: Docker Compose (Recommended)

Run a single command to launch the App, Database, and Network.

docker-compose up -d --build

🔑 Default Credentials

User ID
SUPER001
Password
superadmin123