Installation

Setting up PostgreSQL and installing Replicator-NG on Windows.

Prerequisites

Replicator-NG runs on Windows 10 or later. It requires:

Installing PostgreSQL

Download and install PostgreSQL from postgresql.org. During installation:

Create a Replicator User

Open pgAdmin or psql and create a dedicated user with database creation privileges:

CREATE USER replicator WITH CREATEDB PASSWORD 'your-secure-password';

This user needs CREATEDB so Replicator-NG can create the target database on first run. You can use --schema mode to auto-create the database.

💡 You don't need to create the target database yourself. Replicator-NG will create it automatically when you run with --schema or click Test Connection in the GUI (which offers a Create Database button if the database doesn't exist).

Installing Replicator-NG

Replicator-NG is distributed as a single .exe file. No installer required (Inno Setup installer coming in Phase 2.5).

  1. Download replicator-ng.exe from the download page
  2. Place it anywhere — your project folder, Program Files, or a dedicated tools directory
  3. For scheduled tasks, keep the path stable (don't move it later)

Verifying the Installation

Open a Command Prompt and test:

replicator-ng --version
replicator-ng --help

To test database connectivity with a config file:

replicator-ng -c replicatorconfig.toml --network
🖥️ GUI users: Launch replicator-ng-gui.exe — the Source and Target panels let you test connections interactively with colour-coded feedback.