Skip to main content

Step 3: Install and configure the agent

This document is for:
Invicti Enterprise on-premises

Use the setup wizard to install the Invicti Enterprise Agent. This document explains how to install the agent and run multiple agents on the same operating system.

tip

You can also install the Invicti Enterprise Agent in silent mode. For more information, see Install the Invicti Enterprise Agent in silent mode.

Install the Invicti Enterprise Agent​

  1. Run the AgentSetup.exe file.
  2. On the Invicti Enterprise Agent Setup window, select Next.
  3. On the Select Installation Folder step, select Next to install to the default folder. Alternatively, select Browse to choose a different installation folder, then select Next.
Installation folder step in the Invicti Enterprise Agent setup wizard
  1. On the Agent Setup step, enter the following values and select Next:
    • Agent Name: any value you choose to identify this agent
    • API URL: your Web App URL
    • API Token: the Access Token from step 8 of the web app configuration wizard. If you didn't copy it during the wizard, find it in Agents > Manage Agents > + Configure New Agent.
note

If you configured SSL/TLS for your Invicti Enterprise Application Server, enter an HTTPS URL (for example: https://ncserver/).

Agent Setup step in the Invicti Enterprise Agent setup wizard
  1. On the Ready to Install step, select Install.
  2. Select Finish to complete the installation.

Prevent the agent from starting automatically​

Once installed, the agent starts automatically. To prevent this:

  1. Open a Command Prompt as administrator.
  2. Navigate to the folder containing AgentSetup.exe.
  3. Run AgentSetup.exe LAUNCH_SERVICE_PROP = 0
Command to prevent the agent from starting automatically

To start the agent later, use either method:

Method 1:

  1. Open a Command Prompt as administrator.
  2. Navigate to the folder containing AgentSetup.exe.
  3. Run AgentSetup.exe -s

Method 2:

  1. Press Windows+R, type services.msc, and press Enter.
  2. Find Netsparker Enterprise Scanning Service - [YOUR_AGENT_NAME].
  3. Right-click it and select Properties.
  4. Set Startup type to Automatic, then select Start.

For more information, see Configuring agent selection.

Install multiple agents on the same operating system​

If you want to install more than one agent on the same system, first install the Invicti Enterprise Agent using the AgentSetup.exe file. Then follow these steps to add more agents.

  1. Copy all files from the default agent's folder to a new folder for the new agent. The default installation path is: C:\Program Files (x86)\Invicti Enterprise Agent.

    For example, if you decided to use Agent-2 as the new agent name:

    xcopy "C:\Program Files (x86)\Invicti Enterprise Agent\*.*" "C:\Program Files (x86)\Invicti Enterprise Agent-2" /yie

    This creates C:\Program Files (x86)\Invicti Enterprise Agent-2 and copies all the required files.

  2. Open appsettings.json in the new agent's folder with a text editor. Set the new agent's name.

  3. Open a Command Prompt as administrator and run the following commands:

    • Navigate to the new agent's folder: 
      cd C:\Program Files (x86)\Invicti Enterprise Agent-2
    • Install the new agent as a Windows Service: 
      Netsparker.Cloud.Agent.exe /i
    • Start the new agent's Windows Service: 
      Netsparker.Cloud.Agent.exe /s

Need help?​

Invicti Support team is ready to provide you with technical help. Go to Help Center

Last updated on
Was this page useful?