Skip to content

CapaOne Agent Installation

The agent service isn’t added to services.msc

Section titled “The agent service isn’t added to services.msc”

CapaOne Agent service is not being added to the services.msc and therefore cannot be started.

Create a new enrollment config on CapaOne for Windows

  1. Open PowerShell as an administrator on the client
  2. Copy the PowerShell code from CapaOne and paste it into the PowerShell terminal.
  3. Remove /qn from the code and run the PowerShell code
  4. Install the CapaOne agent from the GUI and see if the service gets started successfully
  5. If the CapaOne Agent is not installing, check the antivirus to ensure the CapaOne Agent service is allowed.

The agent service is installed but doesn’t start

Section titled “The agent service is installed but doesn’t start”

The CapaOne Agent installs, and the COA service exists in services.msc, but the service doesn’t start. Reinstalling the agent doesn’t help. This can happen after the computer was forced to shut down or restart.

When the agent starts, it unpacks files to C:\Windows\SystemTemp\.net\COA. The agent reuses this folder when you install it again. If a file in the folder is damaged or missing, the service stops every time it starts, no matter how often you reinstall.

Uninstall tools such as Revo Uninstaller don’t remove this folder. The agent includes its own .NET runtime, so repairing .NET or Windows doesn’t help either.

  1. Uninstall the CapaOne Agent.
  2. Delete these folders, if they exist:
    • C:\Windows\SystemTemp\.net\COA
    • C:\Windows\Temp\.net\COA
  3. Restart the computer.
  4. Install the agent again.

The COA service starts.

If the service still doesn’t start, remove everything the agent leaves on the computer before you install it again.

  1. Uninstall the CapaOne Agent.

  2. Delete the COA service, if it still exists. In a command prompt as an administrator, run sc.exe delete COA.

  3. Delete these folders, files, and registry keys, if they exist:

    Type Location
    Folder C:\Program Files\CapaSystems\COA
    Folder C:\ProgramData\CapaSystems\COA
    Folder C:\Windows\SystemTemp\.net\COA
    Folder C:\Windows\Temp\.net\COA
    File C:\Windows\System32\config\systemprofile\AppData\Local\CoaRecovery.json
    Registry key HKLM\SOFTWARE\CapaSystems\CapaOneAgent

    Don’t delete the whole CapaSystems folder or the HKLM\SOFTWARE\CapaSystems key. CapaInstaller uses them too.

  4. Restart the computer.

  5. Install the agent again.

To clean up many computers, you can write your own script that removes the locations in the table. Test it on one computer first.

The computer can appear as a new device in CapaOne after a clean reinstall. Delete the old device in the CapaOne portal.

If the service still doesn’t start, check whether your antivirus has quarantined or removed an agent file, such as Serilog.Sinks.File.dll. Restore the file, and then do a clean reinstall.

To stop it from happening again, you can exclude these folders from antivirus scanning:

  • C:\Program Files\CapaSystems\COA
  • C:\Windows\SystemTemp\.net\COA

These exclusions are a recommendation only. Exclusions reduce the protection on the computer, so check with your security team before you add them.