Codenica Insight Agent is a small program installed on a computer that should be included in monitoring. Its role is to send Codenica the data needed to analyze workstation work, computer activity, used applications, system events and other areas enabled in monitoring settings. After a successful installation, the agent runs in the background and does not require daily action from the computer user.

The installer download is available at the top of the monitoring views. The panel includes the Download agent installer button and expandable help called How to install the monitoring agent. The most important point is that the installation package is prepared for a specific company. This means that the connection configuration for your Codenica environment is already included with the installer.

In practice, installation is very simple:

  1. Open any monitoring view in Codenica.
  2. Click Download agent installer.
  3. Extract the downloaded ZIP package on the computer you want to monitor.
  4. Run install-agent.bat as administrator.
  5. Wait for the installation to finish.

The computer must have Microsoft .NET Desktop Runtime 10.0.8 or later installed. If the runtime is not yet available on the computer, download it from Microsoft: download .NET 10. The monitoring panel also includes a button that opens the direct .NET 10.0.8 installer.

What is included in the monitoring agent installation package?

The downloaded file is a ZIP package prepared for your company. It is not a random, generic installer. The system adds a configuration file with the information required to connect the agent to the correct Codenica environment. As a result, the person installing the agent does not need to manually enter the company identifier, server address or other technical parameters.

After extracting the folder, you will find, among other files:

  • codenica-insight-agent-installer.exe - the actual installer for Codenica Insight Agent.
  • codenica-insight-agent.config.json - configuration prepared for a specific company and Codenica environment.
  • install-agent.bat - the simplest startup file for installation on a single computer.
  • install-agent.ps1 - the PowerShell script used by the BAT file, also useful for remote or automated installation.
  • Instruction files in several languages describing the package contents and the basic installation method.

The main rule is simple: for standard installation, use install-agent.bat. It starts the process in the correct order and uses the configuration included in the package.

Codenica Insight Agent installation step by step

Standard monitoring agent installation does not require manually copying files to system folders. The package includes a script that performs the required actions automatically. The user only needs to start the installation with the correct permissions.

  1. Download the installation package from the monitoring panel in Codenica.
  2. Move the package to the computer that should be monitored.
  3. Extract the entire ZIP folder. Do not run files directly from the archive preview.
  4. Check that the extracted folder contains install-agent.bat, install-agent.ps1, codenica-insight-agent-installer.exe and codenica-insight-agent.config.json together.
  5. Right-click install-agent.bat.
  6. Select Run as administrator.
  7. Wait until the script finishes and displays the final message.

Administrator permissions are required because the agent installs a Windows service, writes program files to Program Files and creates configuration in ProgramData. If the BAT file is started without these permissions, the installation will stop and ask you to run it again as administrator.

.NET 10.0.8 or later is required

Codenica Insight Agent requires Microsoft .NET Desktop Runtime 10.0.8 or later. This is a free Microsoft system component that allows desktop applications built on .NET to run. You do not need to install the full development environment or SDK if the computer only needs to run the agent.

If you are not sure whether the runtime is already installed, the simplest approach is to treat it as the first preparation step for the computer. Download the current runtime from the official Microsoft website: .NET 10.0 - downloads. In Codenica, the installation instructions also include a Download .NET 10.0.8 button that opens the direct installer for Windows x64.

  • Minimum required version: .NET Desktop Runtime 10.0.8.
  • You can install a newer version from the same line if Microsoft provides a more recent package.
  • On a typical Windows x64 computer, choose Windows Desktop Runtime x64.
  • After installing the runtime, return to the agent folder and run install-agent.bat.

What happens after running the BAT file?

The install-agent.bat file starts a PowerShell script that performs the actual installation. First, it checks whether it is running with administrator permissions. Then it prepares the agent configuration directory, copies codenica-insight-agent.config.json to the location used by the program and saves it as agentsettings.json. Only then does it start the EXE installer.

During installation, a Windows service named CodenicaInsightAgent is created. The service starts automatically and is responsible for running the agent in the background. After installation, the agent should start working on its own, and new data will begin to reach the system according to the monitoring configuration and synchronization schedule.

The most important locations after installation:

  • C:\Program Files\Codenica Insight Agent - the default program folder.
  • C:\ProgramData\Codenica\InsightAgent - the data, configuration and logs folder.
  • C:\ProgramData\Codenica\InsightAgent\Config\agentsettings.json - the actual configuration file used after installation.
  • C:\ProgramData\Codenica\InsightAgent\Logs - the technical logs folder.

What should you remember when installing the monitoring agent?

The installation is simple, but a few rules help avoid common problems. The most important one concerns the order in which files are started: do not begin with the EXE installer alone, because the company configuration is stored in a separate JSON file. The BAT file makes sure that the configuration is copied to the correct location before the program is installed.

  • Do not run codenica-insight-agent-installer.exe as the first file.
  • Do not remove codenica-insight-agent.config.json from the extracted folder.
  • Do not edit the configuration manually unless you know exactly what you want to achieve.
  • Run install-agent.bat as administrator.
  • Before installation, make sure the computer has the required .NET Desktop Runtime 10.0.8 or later.
  • For remote installation, you can use install-agent.ps1, but it must be run from a folder containing the EXE installer and the configuration file.

After a successful installation, future versions of Codenica Insight Agent will be updated automatically. This means that neither the computer user nor the administrator has to manually download a new installer every time an agent update is released.