Documentation
Getting Started
Data Grid
Modeling
Business Rules
Approvals
Users, Roles & Security
Administration
Integration & API
Installation
Migrating from MDS
Architecture
System Requirements
Installation steps
1
Install SQL ServerRequired
Stores all master data, models, entities, and audit history
SQL Server 2016+ — requires CREATE OR ALTER, OPENJSON, and FOR JSON PATH. Skip if you already have one.
Enable TCP/IP — Primentra connects over the network, not named pipes
Start SQL Server Browser service — required to resolve named instances
Optional: Enable Full-Text Search for faster word search on large datasets
2
Create database & service accountRequired
Creates the Primentra database, a dedicated login, and permissions
Run setup-db-and-user.sql as sysadmin in SSMS
Change the default password first — the script ships with a placeholder password
3
Install PrimentraRequired
Run the installer, then open the app — a setup wizard walks you through connecting the database, deploying the schema, and creating your admin account
Run Primentra-Setup-vX.X.X.exe as Administrator
Node.js LTS installed automatically if missing or too old
★
Production deployment (IIS)Optional
Optional — HTTPS, custom domain, or port 80/443 access
IIS with URL Rewrite for SPA + ARR reverse proxy for /api
Primentra runs on Windows and stores everything in SQL Server. Check these requirements before you start.
Operating system
- Windows 10, Windows 11, or Windows Server 2016 or later.
- Administrator rights. The installer registers a Windows service and writes to
C:\Program Files\.
The installer warns you on Windows builds older than 14393 (Windows Server 2016) and lets you continue at your own risk.
SQL Server
- SQL Server 2016 or later — Express, Standard, or Enterprise.
- The instance can run on the same machine or on any reachable server on the network.
- An existing instance is fine. You do not need a dedicated one.
Primentra needs SQL Server 2016 because it uses CREATE OR ALTER, OPENJSON, and FOR JSON PATH. Older versions cannot run the schema script.
Full-Text Search is optional. It speeds up search on large datasets. See Install SQL Server.
Memory and disk
| Resource | Requirement |
|---|---|
| RAM | 4 GB minimum, 8 GB for datasets over 100,000 rows |
| Disk (application) | About 170 MB of application files and Node.js runtime |
| Disk (database) | About 145 MB for an empty database, then roughly 1 GB per million records |
Network
- Port
3001by default. You choose the port during installation. - Users reach the application at
http://SERVER-IP:PORT.
Node.js
You do not have to install Node.js yourself. The installer bundles Node.js LTS and installs it when Node is missing or older than v18.
Related
- Install SQL Server — prepare the database engine
- Install Primentra — run the installer and complete first-run setup
- Production Deployment (IIS) — HTTPS, a custom domain, and port 80/443
- System Architecture — how the browser, API and database fit together