Install a standalone collector Documentation

Registration

Create the YAML URL first

Sign in to Pcapillary and open Collectors.
Choose Add collector, enter a recognizable host or site name, and select Register standalone collector.
Copy the generated YAML download URL. The URL is stable and can be opened without a browser session.
Run the command below on the target Linux host, or download the YAML before starting the Windows installer.

Linux shell

curl --fail --location 'CONFIGURATION_URL_FROM_PCAPILLARY' --output collector.yaml
chmod 600 collector.yaml

This registration-and-curl flow is the supported installation path when collector auto-registration is disabled. Auto-registration does not need to be enabled for the generated URL to work.

Current release

Download collector release v0.1.9

Copy a direct package URL or a complete curl command for the target system.

Target	Package	Copy
Windows x64	`pcapillary-collector_0.1.9_windows_amd64_setup.exe`
Debian / Ubuntu amd64	`pcapillary-collector_0.1.9_linux_amd64.deb`
Debian / Ubuntu arm64	`pcapillary-collector_0.1.9_linux_arm64.deb`
RHEL compatible x86_64	`pcapillary-collector_0.1.9_linux_x86_64.rpm`
RHEL compatible aarch64	`pcapillary-collector_0.1.9_linux_aarch64.rpm`
Checksums	`SHA256SUMS`

View release v0.1.9 on GitHub or browse all releases.

Windows installation

Install the Windows x64 collector

Install Npcap from npcap.com.
Download the current Windows installer and SHA256SUMS.
Verify the checksum, run the installer, and select the YAML downloaded during registration.

Silent PowerShell installation

pcapillary-collector_0.1.9_windows_amd64_setup.exe /S /CONFIG=C:\staging\collector.yaml

The installer registers the delayed-start PcapillaryCollector service. Data lives under C:\ProgramData\Pcapillary; logs go to the Windows Application event log.

Linux installation

Install a DEB or RPM package

Ubuntu or Debian

VERSION=0.1.9
curl --fail --location 'CONFIGURATION_URL_FROM_PCAPILLARY' --output collector.yaml
curl -fLO https://github.com/qwerty-iot/pcapillary-releases/releases/download/v0.1.9/pcapillary-collector_0.1.9_linux_amd64.deb
curl -fLO https://github.com/qwerty-iot/pcapillary-releases/releases/download/v0.1.9/SHA256SUMS
grep "pcapillary-collector_$VERSION_linux_amd64.deb" SHA256SUMS | sha256sum --check -
sudo apt install ./pcapillary-collector_$VERSION_linux_amd64.deb
sudo install -m 0640 -o root -g pcapillary collector.yaml /etc/pcapillary/collector.yaml
sudo systemctl enable --now pcapillary-collector

RHEL compatible

VERSION=0.1.9
curl --fail --location 'CONFIGURATION_URL_FROM_PCAPILLARY' --output collector.yaml
curl -fLO https://github.com/qwerty-iot/pcapillary-releases/releases/download/v0.1.9/pcapillary-collector_0.1.9_linux_x86_64.rpm
curl -fLO https://github.com/qwerty-iot/pcapillary-releases/releases/download/v0.1.9/SHA256SUMS
grep "pcapillary-collector_$VERSION_linux_x86_64.rpm" SHA256SUMS | sha256sum --check -
sudo dnf install ./pcapillary-collector_$VERSION_linux_x86_64.rpm
sudo install -m 0640 -o root -g pcapillary collector.yaml /etc/pcapillary/collector.yaml
sudo systemctl enable --now pcapillary-collector

Packages are published for amd64/arm64 DEB and x86_64/aarch64 RPM systems. The service runs with only CAP_NET_RAW and CAP_NET_ADMIN.

Verification

Confirm the collector is online

Return to Collectors.
Confirm the expected hostname, platform, and interfaces appear.
Review the service log if a collector remains offline.
Run a short test capture after registration succeeds.