Configuring the Client (Printing) Agent (Web Client)

The Client Agent is a small program installed on your PC that allows you to print badges. This program must be installed on the same PC as your printers.

Steps to Configure a New Client Agent

  1. Go to Settings in your client and scroll down to the Client Agent section.
  2. Click Setup to begin.

Client Agent

New – Will guide you through the setup of a new Client Agent.

Existing – Will allow you to reconfigure or delete existing Client Agents.

Client Agent Setup

  1. Select New, then Windows.

Operating System

  1. Locate and run the file (labeled client_agent_latest.msi) when it is finished downloading. During installation, you will see a few command prompt windows appear; this is normal. The installation should only take a few seconds to complete.

Client Agent Download

  1. Once completed, head back to the download page and click Continue


You can rename the Client Agent. Also, there are advanced options and logs for troubleshooting. (We will discuss this more below.)

Configure Client Agent

Advanced Settings has options for port numbers to use, our endpoints that we use (you shouldn’t need to change this), and an option to generate a new security key in case the client agent is compromised (highly unlikely).

Advanced Settings

There are also options for:

Advanced Settings 2

Allow Remote Access – By enabling this you can print badges to one central location from multiple check-in stations.

Enable Debugging – It is important to enable this if you experience issues printing badges.

TLS Insecure Skip Verify – This should never be enabled unless directed to by CENTEGIX support.

Once you are done, click Apply Changes. You should receive a green success message.

Steps to Connect an Existing Client Agent

You may purchase a system from us with the Client Agent already installed. In this case, we need to connect the Agent.

  1. Open the shortcut to your check-in station on the desktop. (If you do not have a station created, click here for a how-to video.)
  2. Log in with a CENTEGIX admin account.
  3. On the Home Page, click the menu bar in the upper left corner, then click Settings.
  4. Scroll down to the Client Agent section and click Setup.
  5. Click New followed by Continue.
  6. Select your school then select your PC the Client Agent is installed on. It will show you the PC Name and IP address. Click Configure.

Connect Client Agent

  1. Rename the Agent if needed, then click Apply Changes.

Troubleshooting the Client Agent

Sometimes the Client Agent will stop working. This can be due to one of a number of different issues. Let’s take a look at some common reasons why your agent stops working and what you can do to fix it.

The most common reason a Client Agent either fails to configure correctly or fails as your user is due to changes in your network or firewall. The Client Agent relies on an unfiltered connection through port 4004 of your network. If this port is compromised or blocked by your firewall it will prevent the Client Agent from working correctly. One easy way to find out if port 4004 is blocked is to type https://localhost:4004 into your web browser. If you see Client Agent API (Version number) then the port is ready for use. If you receive an error, you may need to adjust your firewall rules.

Steps to Reconfigure the Client Agent

In the event that you cannot fix the Client Agent, a reset must be done.

To reset the Client Agent:

  1. Remove the old Client Agent. In your Web Client Settings page, navigate to the Client Agent area and click Setup. Then click Existing and select your school and the name of the Client Agent you wish to remove, then click Remove. You may get a message about deleting a folder on your computer. We will go over this below.
  2. Once the old Client Agent is removed, open Windows File Explorer on your computer. (Default shortcut Windows Key+E) Here, you need to navigate to C:\ccssvmclientagent\workdir\storage and delete the storage.json file there.
  3. Once that file is deleted, open Task Manager. (Default shortcut Ctrl+Shift+Esc) Click the Services tab and find ccssvmclientagent. Right-click it and click Restart. This will stop and restart the service AND recreate the storage.json file you deleted in the previous step. This effectively resets the Client Agent back to default settings.
  4. Set up the Client Agent using the instructions at the top of this page, but instead of downloading and running the file again, click on Continue.

Need help resetting Client Agent? Watch This video.