1. Home
  2. Docs
  3. Backup Ninja
  4. Installation
  5. Windows Agent Installation

Windows Agent Installation

Let’s see different ways to install the Backup Ninja agent on Windows systems.


All the commands below should be run as Administrator.

Install and configure MySQL Server

Go to https://dev.mysql.com/downloads/installer/ and download the MSI Installer.

Run the downloaded file and follow the installation instructions.

Add the MySQL server bin directory to a system PATH variable (eg. C:\Program Files\MySQL\MySQL Server 8.0\bin). The mysql.exe and mysqldump.exe binaries must be in a system PATH the directory in order to make the agent work properly:

From the GUI:

  1. Go to Control Panel → System and Security → System
  2. Open Advanced system settings
  3. Click on Environment Variables
  4. Find the Path variable in the System variables list and double-click on it
  5. Click New
  6. Paste your MySQL server bin directory there (eg. C:\Program Files\MySQL\MySQL Server 8.0\bin)
  7. Click OK

From PowerShell:

$ [Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\MySQL\MySQL Server 8.0\bin", "Machine")

From the command prompt (cmd.exe):

$ SETX /M Path "%Path%;C:\Program Files\MySQL\MySQL Server 8.0\bin"

MongoDB and PostgreSQL servers could be installed in a similar way and should work, but the agent was tested only using the MySQL server.


Go to https://chocolatey.org/install and install the required software.

Add a Backup Ninja agent source:

$ choco source add -n bartender -s "'https://winrepo.s9s.io/nuget/bartender-choco/'"

Install the agent by running:

$ choco install bartender --install-args="'API_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx DB=mysql://user:[email protected]:3306'"

API_KEY and DB values could be copied from the Backup Ninja UI.

MSI Installer

Download the latest MSI installer from https://winrepo.s9s.io/assets/bartender/bartender.msi. And then, you can run it using:

  • PowerShell:
Start-Process -Wait msiexec -ArgumentList '/qn /i bartender.msi API_KEY=xxx-xxxx-xxx DB=mysql://root:[email protected]:3306'
  • Command prompt (cmd.exe):
start /wait msiexec /qn /i bartender.msi APIKEY="xxx-xxxx-xxx" DB="mysql://root:test[email protected]:3306"
  • UI: Run the *.msi file under the Administrator user. Paste API_KEY and DB values to corresponding fields.

Was this article helpful to you? Yes No