Become a CreatorSign inGet Started

Configure Windows client with pGina.

This article provides step by step guide to installing pGina on your windows machine. To achieve this I used a Virtual box and created a windows machine.



4 months ago | 1 min read


pGina is a pluggable, open-source credential provider (and GINA) replacement. It allows for alternate methods of interactive user authentication and access management on machines running the Windows operating system.

Download and install pGina stable version setup from

This configuration was performed within a virtual box.

To start check/verify the IP of your windows machine using ipconfig .

After installation of pGina, launch pGina application.

Click on Plugin selection and check all 3 boxes as shown in the image below.
Plugin Name: LDAP: Authentication, Authorization and Gateway, then click on configure to continue the set-up.

Fill in the required information.

For LDAP host, we use the IP of or machine which is advisable to use in case you make a mistake the hostname and users would be unable to access.

For the LDAP Port, we do not require to make any changes to the port.

Edit the Search DN and edit the required information and replace it with your own LDAP server details dc=labwork,dc=local. Fill in the rest as shown and click on save.

Click on Plugin Order, select the LDAP plugin and use the arrow provided to move it to the top.

Click on the Simulation tab next as we would try to simulate using an actual user to check if our set-up I correct.

Here we use the user which is the name attached to your machine upon creation and the password of the machine.

Then you can click on apply and save & close. Shut down your machine and try logging in with the user as used in the simulation.


You are now ready to use pGina to log into Windows machines!


Created by



Azure Cloud Engineer| Technical Writer







Related Articles