Linux Binary
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 app.qpoint.io (Settings → Installation)
Installation
Quick Install
curl -s https://get.qpoint.io/install | sudo sh
Manual Installation
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
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
Replace $TOKEN
with your actual registration token from app.qpoint.io.
Running as a Service
Service Configuration
Create environment file for secure token storage:
sudo mkdir -p /etc/qtap && \
sudo touch /etc/qtap/environment && \
sudo chmod 600 /etc/qtap/environment
Add your registration token:
echo "REGISTRATION_TOKEN=your_registration_token_here" | sudo tee /etc/qtap/environment
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
Reload systemd:
sudo systemctl daemon-reload
Start the service:
sudo systemctl start qtap
Enable service to start on boot:
sudo systemctl enable qtap
Check service status:
sudo systemctl status qtap
View service logs:
sudo journalctl -u qtap -f
Updating the Service
Stop the service:
sudo systemctl stop qtap
Replace the binary:
sudo mv new-qtap /usr/local/bin/qtap
sudo chmod +x /usr/local/bin/qtap
Restart the service:
sudo systemctl start qtap
Verify the update:
qtap --version
sudo systemctl status qtap
Last updated