Documentation
  • Introduction
    • How It Works
    • Architecture & Data Flow
    • Why another Agent?
    • eBPF Concepts
    • Use Cases
  • Deployment
  • Qtap
    • Getting Started
    • System Requirements
    • Installation
      • Linux Binary
      • Docker Container
      • Helm Chart
      • Kubernetes Manifest
    • Configuration
      • Storage Configuration
      • Traffic Processing with Plugins
      • Traffic Capture Settings
      • Configuration Examples
  • Qplane
    • Getting Started
      • Create an Account
      • Install Qtap
      • Review your Dashboards
    • Installation
      • Linux Binary
      • Docker Container
      • Helm Chart
    • Configuration
  • Security & Compliance
  • License
  • Appendix
    • Qcontrol (Beta)
    • Java
    • Object Storage
      • Google Cloud Storage
    • S3 Credentials for Qtap using Kubernetes Secrets
  • FAQ
Powered by GitBook
On this page
  • Preflight Check
  • Prerequisites
  • Installation
  • Quick Install
  • Manual Installation
  • Running with Registration Token
  • Running as a Service
  • Service Configuration
  • Managing the Service
  • Updating the Service
  1. Qplane
  2. Installation

Linux Binary

PreviousInstallationNextDocker Container

Last updated 11 days ago

This guide covers installing and running Qtap as a Linux binary in cloud-connected mode, managed through the Qplane control plane.

Preflight Check

Verify your environment's compatibility:

curl -sSL https://github.com/qpoint-io/preflight/releases/latest/download/preflight.sh | sudo bash

Prerequisites

  • Linux host with kernel 5.10+

  • Root/sudo access

  • x86_64 or arm64 architecture

  • Registration token from (Settings → Installation)

Installation

Quick Install

curl -s https://get.qpoint.io/install | sudo sh

Manual Installation

  1. Download the appropriate binary:

For x86_64:

curl -L https://downloads.qpoint.io/qpoint/qtap-v0.9.7-linux-amd64.tgz -o qtap.tgz

For arm64:

curl -L https://downloads.qpoint.io/qpoint/qtap-v0.9.7-linux-arm64.tgz -o qtap.tgz
  1. Extract and install:

tar -xzf qtap.tgz && \
    sudo mv qtap-* /usr/local/bin/qtap && \
    sudo chmod +x /usr/local/bin/qtap

Running with Registration Token

Run Qtap in cloud-connected mode:

sudo qtap --registration-token=$TOKEN

Running as a Service

Service Configuration

  1. Create environment file for secure token storage:

sudo mkdir -p /etc/qtap && \
    sudo touch /etc/qtap/environment && \
    sudo chmod 600 /etc/qtap/environment
  1. Add your registration token:

echo "REGISTRATION_TOKEN=your_registration_token_here" | sudo tee /etc/qtap/environment
  1. Create systemd service file:

sudo nano /etc/systemd/system/qtap.service

Add the following content:

[Unit]
Description=Qtap Traffic Analysis Service
After=network.target
StartLimitIntervalSec=0

[Service]
Type=simple
User=root
EnvironmentFile=/etc/qtap/environment
ExecStart=/usr/local/bin/qtap --registration-token=${REGISTRATION_TOKEN}
Restart=always
RestartSec=1

[Install]
WantedBy=multi-user.target

Managing the Service

  1. Reload systemd:

sudo systemctl daemon-reload
  1. Start the service:

sudo systemctl start qtap
  1. Enable service to start on boot:

sudo systemctl enable qtap
  1. Check service status:

sudo systemctl status qtap
  1. View service logs:

sudo journalctl -u qtap -f

Updating the Service

  1. Stop the service:

sudo systemctl stop qtap
  1. Replace the binary:

sudo mv new-qtap /usr/local/bin/qtap
sudo chmod +x /usr/local/bin/qtap
  1. Restart the service:

sudo systemctl start qtap
  1. Verify the update:

qtap --version
sudo systemctl status qtap

Replace $TOKEN with your actual registration token from .

app.qpoint.io
app.qpoint.io