Install Lens where the work is.

Raspberry Pi OS, Debian and Ubuntu

Download the Debian package for the target from GitHub Releases. Check the architecture on the device, install the matching package through apt, then open Lens:

dpkg --print-architecture
sudo apt install ./dataplicity-lens_<version>_<architecture>.deb
lens

apt registers the package with the system, installs all nine commands and their manual pages, and makes later removal straightforward.

Choose the package for the device

The armhf build uses the hard-float ABI expected by 32-bit Raspberry Pi OS. Choose the package from the target's reported userland architecture, not from the CPU model printed on its box.

Verify the download

Download SHA256SUMS beside the release artifact and verify the selected file before installation:

sha256sum --check --ignore-missing SHA256SUMS

The package or archive must report OK. On macOS use shasum -a 256 -c SHA256SUMS.

Get useful data immediately

lens
lens-top --once
lens-hardware --plain

lens is the live overview. Open a specialist from there, or run any of the eight specialist commands directly. lens-hardware checks temperatures, firmware and attached devices. Press a on a process or systemd service to review an exact action before confirming it. Press ! for a local diagnostic shell alongside the live view.

Upgrade the complete suite

Download the newer package for the same architecture, verify it and install it through apt. The package replaces every Lens command together.

sudo apt install ./dataplicity-lens_<new-version>_<architecture>.deb
lens-top --version

Other Linux systems

Debian and RPM packages contain statically linked binaries, keeping them compatible with current Raspberry Pi OS and Debian systems that ship older glibc versions. Releases also contain checksummed GNU and musl archives for x86-64, ARM64 and ARM hard-float. Archive installs are not registered with a package manager, so replace or remove all nine binaries together. See the compatibility matrix for native facilities and container behaviour.

macOS with Homebrew

Add WildFoundry's tap, trust the formula, install the complete suite, verify the installed version, then open Lens. The formula selects the native Apple Silicon or Intel archive and does not compile Rust locally.

brew tap wildfoundry/tap
brew trust --formula wildfoundry/tap/dataplicity-lens
brew install wildfoundry/tap/dataplicity-lens
lens --version
lens

Homebrew verifies the published archive digest before installation. The current release reports lens 0.3.0. To upgrade later, run brew update followed by brew upgrade dataplicity-lens. macOS privacy controls may make some unified-log or process fields unavailable; Lens reports that without failing the rest of the view.

Remove Lens

# Raspberry Pi OS, Debian or Ubuntu
sudo apt remove dataplicity-lens

# macOS
brew uninstall dataplicity-lens

Build from source

Source builds are mainly for contributors. Operators should prefer a release package so the build is identifiable and the installation can be cleanly upgraded or removed.

cargo build --release --locked --workspace
./target/release/lens

Continue with the command reference, or use troubleshooting when a native source is incomplete.