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+
x86_64 or arm64 architecture
Registration token from (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
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
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
sudo systemctl daemon-reload
sudo systemctl start qtap
Enable service to start on boot:
sudo systemctl enable qtap
sudo systemctl status qtap
sudo journalctl -u qtap -f
Updating the Service
sudo systemctl stop qtap
sudo mv new-qtap /usr/local/bin/qtap
sudo chmod +x /usr/local/bin/qtap
sudo systemctl start qtap
qtap --version
sudo systemctl status qtap