Documentation
Use Primentra
Getting Started
Data Grid
Approvals
Set up
Modeling
Business Rules
Users & Roles
Sign-in & Security
Install and run
Installation
Administration
Integration & API
Architecture
Migrate from MDS
Migrating from MDS
Documentation/Installation/Install Primentra

Install Primentra

On this page

The installer sets up Primentra as a Windows service that starts on boot. It installs Node.js, registers the service, and adds a firewall rule for you.

Run the installer

  1. Download the installer from your Primentra account at primentra.com/account, page Download. A trial downloads it from primentra.com/download.
  2. Right-click the file and choose Run as administrator.
  3. Accept the license agreement.
  4. Choose the installation folder. The default is C:\Program Files\Primentra.
  5. Choose the port. The default is 3001. The installer checks whether the port is free and suggests another one if it is not.
  6. Choose how users will reach Primentra: Direct access on this port, which adds a Windows Firewall inbound rule, or Via IIS reverse proxy, which adds no rule and keeps the port internal.
  7. Choose whether to create Start Menu shortcuts.
  8. Click Install.
  9. Leave Open Primentra in your browser checked on the last screen.

What the installer does

  • Installs Node.js LTS when Node is missing or older than v22.15. If an older Node.js is on the server, the installer asks before it upgrades it.
  • Registers a Windows service named Primentra with automatic start.
  • Writes service logs to {install folder}\logs\.
  • Grants the service write access to the install folder.
  • Starts the service and waits until /api/health answers.
  • Opens http://localhost:{port} in your browser.

Which account the service runs under

The service runs as Local System (NT AUTHORITY\SYSTEM). The installer gives SYSTEM and LOCAL SERVICE modify rights on the install folder, so the service can write its logs and mds-config.json.

Primentra does not use this account for the database. It signs in to SQL Server with the SQL login in mds-config.json, normally primentra_svc.

To use another account:

  1. Open Services, right-click Primentra and choose Properties.
  2. On the Log On tab, enter the account and its password.
  3. Give the account modify rights on the install folder. Also grant it on mds-config.json and mds-config.json.bak one by one, because Primentra closes those two files at each start and a folder grant no longer reaches them: icacls "<install folder>\mds-config.json" /grant "<account>:M".
  4. Restart the service.

An upgrade keeps the account you set. The installer stops the existing service, updates its settings and starts it again. It does not register a new service.

Upgrading an existing installation? Run the new installer over it. It detects the previous version, keeps your port, and leaves the database untouched. See Upgrading.

First-time setup

The first time you open Primentra in a browser it walks you through three screens.

The first-run setup wizard, connecting Primentra to SQL Server
The first-run setup wizard, connecting Primentra to SQL Server(click to enlarge)
  1. On Connect to SQL Server, fill in the connection fields listed below.
  2. Click Test connection. Wait for "Connection successful". If the test fails, the screen lists the checks to make.
  3. Click Save & continue.
  4. On Create database schema, click Setup database. Primentra creates all tables, stored procedures and indexes. This takes a few seconds.
  5. Click Continue.
  6. On Create your administrator account, enter your email, display name and password. Use Generate for a strong random password.
  7. Click Create account & continue. You are signed in and land on the dashboard.

Connection fields

FieldValue
ServerThe machine SQL Server runs on, for example localhost or SQLSERVER01. Pasting SERVER\INSTANCE splits itself over the two fields
InstanceOptional. Leave empty for the default instance. Enter the name, such as SQLEXPRESS, for a named instance
DatabasePrimentra, or the name you chose in setup-db-and-user.sql
PortOptional. Leave empty to auto-detect. Default instances use 1433; named instances are resolved by SQL Server Browser
Usernameprimentra_svc
PasswordThe password you set in setup-db-and-user.sql
Trust server certificateLeave checked for a self-signed certificate, which is the default SQL Server install. Uncheck it only when the server has a CA-signed certificate
The administrator screen appears only while no accounts exist. After that, everyone signs in.

Check the scheduler job

setup-db-and-user.sql creates a SQL Agent job named Primentra_Scheduler. It runs every minute and does two things: it fires scheduled and trigger-based staging batches, and it applies your retention settings. Without it both fail silently — staging runs in Manual mode only, and nothing is ever purged.

You do not have to hunt for it. Settings › General Settings › Database reports the job after every setup run: a missing job gets an amber warning naming the script that repairs it.

To confirm it by hand, connect as a sysadmin:

SELECT name, enabled FROM msdb.dbo.sysjobs WHERE name = 'Primentra_Scheduler';

Make sure the SQL Server Agent service runs and starts automatically. The job cannot fire without it.

If the query returns no rows, connect as a sysadmin and run scripts\create-scheduler-agent-job.sql from the install folder. This happens when setup-db-and-user.sql was never run — for example on a database created by hand.

SQL Server Express has no SQL Server Agent at all. Setup reports this and continues. Schedule usp_Scheduler_Dispatch and usp_Maintenance_Cleanup from Windows Task Scheduler instead.

Next steps

  • Create your first model and entities under Settings › Models.
  • Add user accounts under Settings › Access Management.
  • Configure SMTP under Settings › General Settings › Email so welcome emails and expiry alerts can go out.

Uninstall Primentra

Open Control Panel › Programs and Features, choose Primentra and click Uninstall. Or run the uninstaller from PowerShell as Administrator:

& "C:\Program Files\Primentra\unins000.exe" /VERYSILENT | Out-Null; Start-Sleep 10; "service left: " + [bool](Get-Service Primentra -ErrorAction SilentlyContinue); "folder left: " + (Test-Path "C:\Program Files\Primentra")

Both lines must say False.

The uninstaller removes the Primentra service, its firewall rule and the install folder, with mds-config.json and the logs. It keeps the database and the SQL login primentra_svc, so your data stays. Node.js also stays installed.

mds-config.json holds the license key and the database connection. To install Primentra again on the same database later, copy the file to a place where only administrators can read it before you uninstall.