Alpine Linux

Install the Sensor on Alpine Linux from the signed generic TGZ. Alpine does not use the Endura DEB or RPM repositories.

Prerequisites

• A current Alpine Linux release on 64-bit hardware
• Root or sudo access
• A supported kernel with BTF at /sys/kernel/btf/vmlinux
• At least 1 GB of available memory
• An Endura license key
• Team Server URL and Sensor token for centralized management

Install the tools used by the installer:

sudo apk add curl gnupg

Install

The installer detects Alpine, downloads the TGZ and detached signature, and verifies it before extraction:

curl -sSf https://repo.endurasecurity.com/install/endura-sensor/testing.sh | sudo -E sh
endura version

Configure

Edit /opt/endura/sensor/environ:

sudo vi /opt/endura/sensor/environ

For Team Server mode, set:

ENDURA_LICENSE_KEY=your_license_key
ENDURA_TEAM_SERVER=https://team-server.example.com
ENDURA_SENSOR_TOKEN=your_sensor_token

Create the token under Sensors in Team Server. Protect the file:

sudo chown root:root /opt/endura/sensor/environ
sudo chmod 600 /opt/endura/sensor/environ

See Configuration for optional variables.

Start and Verify

Alpine’s generic installation runs the Sensor directly:

sudo endura sensor start -d
endura sensor wait
endura sensor status
endura license verify

For Team Server mode, confirm the Sensor and a deployment for this host appear in Team Server.

Operate the Sensor

# Status
endura sensor status

# Logs
sudo endura sensor logs -f

# Hook coverage
sudo endura sensor hooks

# Stop
sudo endura sensor stop

Update

Re-run the signed installer:

sudo endura sensor stop
curl -sSf https://repo.endurasecurity.com/install/endura-sensor/testing.sh | sudo -E sh
sudo endura sensor start -d
endura sensor wait
endura version

Review Team Server Compatibility before a major update.

Uninstall

Stop the Sensor first:

sudo endura sensor stop

sudo rm -f /usr/bin/endura
sudo rm -f /etc/systemd/system/endura-sensor.service
sudo rm -f /etc/systemd/system/endura-sys-fs-bpf.mount
sudo rm -f /etc/systemd/system/endura-sys-kernel-security.mount
sudo rm -r /opt/endura/sensor
sudo rm -r /var/log/endura

Troubleshooting

Sensor Does Not Start

endura sensor status
sudo endura sensor logs -n 100
test -r /sys/kernel/btf/vmlinux && echo "BTF available"
uname -r

Check the license, environment-file permissions, BTF availability, and startup error.

Team Server Is Offline

curl -v https://team-server.example.com/_readiness
nslookup team-server.example.com

Confirm outbound TCP 443 and certificate trust. An incompatible state requires matching major versions; see Team Server Compatibility.

Installation Fails

gpg --version
df -h /opt
ldd /usr/bin/endura 2>/dev/null || true

Confirm that gnupg is installed and the target filesystem has space.