Installation Guide: VectraOps Linux Agent Guide

VectraOps documentation

Installation Guide: VectraOps Linux Agent

This document explains how to securely copy the VectraOps Linux Agent package to a server, install it under <code>/opt/vectraops-agent</code>, and verify the agent service and version after installation.

Last updated January 16, 2026 vectraops linux agent installation ssh scp systemd monitoring documentation

Installation: VectraOps Linux Agent

Follow the steps below to install the VectraOps Linux Agent on a Linux server using SSH and SCP.

Prerequisites

  • You have SSH access to the target server.
  • You have sudo (root) privileges on the target server.
  • You have the agent package available locally: vectraops_agent_linux_demo-corp_1_0_15.tar.gz

1) Connect to the target server (SSH)

Use SSH to log in to the Linux server:

ssh <username>@<ip-address>

2) Copy the agent package to the server (SCP)

From your local machine, copy the package to the home directory of the target server:

scp vectraops_agent_linux_demo-corp_1_0_15.tar.gz <username>@<ip-address>:~/

3) Create the installation folder

Create the target folder where the agent will be installed:

sudo mkdir -p /opt/vectraops-agent

4) Move the package to the installation folder

sudo mv ~/vectraops_agent_linux_demo-corp_1_0_15.tar.gz /opt/vectraops-agent/

5) Change to the installation folder

cd /opt/vectraops-agent

6) Extract the package

sudo tar xvf vectraops_agent_linux_demo-corp_1_0_15.tar.gz

7) Make the installer executable

sudo chmod +x install_agent.sh

8) (Optional) Update package sources (Debian/Ubuntu)

sudo apt update

9) Install required packages (Debian/Ubuntu)

Install Python and required components used by the agent installer:

sudo apt install -y python3-venv python3.12-venv python3-pip

10) Install the agent

Run the installation script using sudo:

sudo ./install_agent.sh

11) Check if the agent service is running

Verify the agent service status:

systemctl status vectraops-agent

Tip: Press q to exit the status view.

12) Check the installed agent version

Confirm the agent version from the agent source file:

grep "AGENT_VERSION" /opt/vectraops-agent/linux_agent.py

Result

  • The VectraOps Linux Agent is installed under /opt/vectraops-agent.
  • The service vectraops-agent should be running and managed by systemd.
  • The server should appear in your VectraOps tenant once it has checked in.

Troubleshooting (quick checks)

  • Service not running? Re-run the installer and review output for errors: sudo ./install_agent.sh
  • Permission issues? Ensure you used sudo for all commands under /opt.
  • Python venv package missing? Run sudo apt update and retry step 9.