Prerequisites
Replicator-NG runs on Windows 10 or later. It requires:
- Microsoft Access (or the Access Database Engine) — to read
.accdb/.mdbfiles via DAO COM - PostgreSQL 14+ — as the target database. Can be on the same machine, another Windows server, or a Linux/macOS host. Only Replicator-NG itself needs to be on Windows — PostgreSQL can run anywhere your network reaches
- No Python, no dependencies, no runtime — it's a single
.exe
Installing PostgreSQL
Download and install PostgreSQL from postgresql.org. During installation:
- Remember the superuser password you set for the
postgresuser - Default port
5432is fine — just note what you choose - You don't need Stack Builder or additional components
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).
- Download
replicator-ng.exefrom the download page - Place it anywhere — your project folder,
Program Files, or a dedicated tools directory - 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.