Back to getpassive.io
Docs/Platform integration/Linux

Linux SDK integration

Install the Linux binary during provisioning and run it from your application process or a systemd unit after user consent.

1. Install

curl -L https://getpassive.io/sdk/binaries/getpassive-sdk-linux-x86_64 -o getpassive-sdk
chmod +x getpassive-sdk

2. Initialize

# Spawn from your app process after the user opts in.
./getpassive-sdk --dev-api-key ${apiKey} --device-uuid <STABLE_DEVICE_UUID> &

# Or via env vars:
GP_DEV_API_KEY=${apiKey} \
GP_DEVICE_UUID=<STABLE_DEVICE_UUID> \
  ./getpassive-sdk &

3. Binary downloads

4. Lifecycle notes

  • Persist a unique GP_DEVICE_UUID per installed device.
  • For systemd, set GP_DEV_API_KEY and GP_DEVICE_UUID in an EnvironmentFile or unit drop-in.
  • Use Restart=on-failure for unattended devices and disable the unit immediately when the user opts out.
  • Run with the least-privileged user account your application can support.

Start the SDK only after your app has shown the required disclosure and the user has accepted it. Use the shared consent guide for the wording and placement expectations.

6. Verify

Use the in-dashboard tester at app.getpassive.io for your app key, or follow the shared quickstart verification steps while the key is in test mode.

Previous← Quickstart / Node.js

Last updated June 14, 2026