The VIPRE Cloud Agent for Linux® is designed to provide comprehensive protection across your infrastructure, supported by every solution in the VIPRE Endpoint Security product line. 

This guide outlines the necessary steps to download, install, and configure the agent, ensuring your Linux-based assets are seamlessly integrated into your central VIPRE console.

Prerequisites

Before continuing, ensure your environment meets the following:

• Review the System Requirements 
  • Note: A minimum of 4GB of space in the /tmp partition is required for a standard installation; for systems with a /tmp partition that is less than the required 4GB will need to utilize a workaround by providing the -f flag to specify an alternative extraction directory; e.g., sudo bash <linux-installer-here>.run -- -f ~/tmp-vipre-install
• You must have root or sudo access on the endpoint to execute the installation script
• Verify that your network configuration allows traffic to the necessary VIPRE servers

Install the VIPRE Cloud Agent

The following instructions assume you are logged in to your subscribed VIPRE Cloud product's web console with administrator credentials:

1. Navigate to SETUP > Deploy Agents and scroll down to the Linux section 
2. If you have an existing policy that you have already created for your Linux endpoints, select Create Policy Installer
   1. If you do not have an existing policy for your Linux endpoints, click Download Installer to generate the installer without a policy, then create a policy later (we'll cover that below)
3. Download the installer file 

   Warning

   DO NOT modify the name of the downloaded installer file. The file name contains a unique token necessary for the agent to successfully install and register with your VIPRE Cloud console. Changing the name will result in an unsuccessful installation.

    
4. Open the Terminal on your Linux endpoint and navigate to the directory containing the installer
   • Example: cd ~/Downloads
5. Still in the Terminal, execute the install script with the following command: sudo bash vce_edr1_linux_\[token-ID].run
   • Don't forget to update [token-ID] to match the actual token ID in the file name before hitting Enter
   • Helpful Hint: You can press the Tab key on your keyboard after typing sudo bash vce to auto-complete the rest of the filename for you, preventing typos
6. Enter your Linux admin password when prompted and press Enter; the process will be displayed in the terminal window, and a confirmation message will indicate that the agent has been successfully installed
7. Once installation is complete, verify the agent status by typing sudo systemctl status vipre in the Terminal; if your agent status does not come back as Active, visit the Troubleshooting section below 

   

Create an Endpoint Policy

If you do not already have policies to configure the agent on your Linux endpoints, this is the time to create them.

1. On the left-side menu, navigate to MANAGE > Policies
2. You'll notice a light blue menu listing different operating systems; ensure you select Linux
3. In the top right corner, click the Add Policy button
4. Name your policy as desired, and click Next
5. You'll notice the light blue menu listing the operating systems has been replaced with policy setting categories; click on each category to see the settings within and configure your policy as desired

What to Expect

The first time the VIPRE Cloud Agent starts, it will automatically download and install Threat Definitions to protect you from the latest threats. This process is automatic and usually takes a minute or two, depending on your connection speed. After this, VIPRE will check for definition updates as configured in your policy (under Agent > Updates & Communications > Definitions Updates) and is set to one hour by default.

The VIPRE Cloud Agent for Linux runs in the background and does not have a graphical user interface (UI). All management, status monitoring, and scan initiation tasks must be performed via the VIPRE Cloud web Console.

Troubleshooting

If you encounter issues during the installation process or find that the agent is failing to connect to the console, please review the following:

1. Verify the Installation File Name

It is critical that the downloaded installation file remains unaltered. The filename contains a unique alphanumeric token, which is required for the agent to successfully register with your VIPRE Cloud console.

If the file was renamed (e.g., VIPRE_Agent(1).pkg), delete it and download a fresh copy from the console, ensuring the file name remains unaltered.

2. Check Network and Firewall Permissions

A successful connection requires an open path between your endpoint and our Cloud infrastructure. If the agent installs but stays “Offline," refer to VIPRE Network Connections and check the following items:

• Ensure your organization’s firewall isn't stripping the registration token or blocking the agent's outbound communication
• Verify that your network configuration allows traffic to the necessary VIPRE servers
• Consult your network administrator to allowlist VIPRE-related domains and ports, then attempt the installation again

3. Review any Known Issues

For a complete list of known issues and available workarounds for the current VIPRE Cloud Agent, please refer to the most recent release notes.

Visit our Endpoint Security product documentation guides for complete details on how to use the VIPRE Cloud web console with VIPRE EDR+MDR, Endpoint Detection & Response, or Endpoint Security Cloud.