Skip to main content
Version: v2 (current)

Install on Linux

Install the PanDev Metrics CLI plugin on Linux in about 3 minutes. After this guide your terminal activity (base command + timestamp) shows up in PanDev Metrics dashboards.

Before you begin​

  • A Linux distribution with Homebrew on Linux installed (docs.brew.sh/Homebrew-on-Linux)
  • A PanDev Metrics account (login + password)
  • The Server URL of your PanDev Metrics instance:
    • Cloud: https://metrics-cloud.pandev.io
    • On-prem: the URL given to you by your admin
tip

If you cannot install Homebrew, ask your administrator for the standalone binary build of the CLI plugin.

Step 1 — Install the plugin​

brew install pandev-metriks/pandev-cli/pandev-cli-plugin

On Linux, Homebrew registers the daemon automatically — no sudo step needed.

Step 2 — Authenticate​

pandev login

Enter Server URL, login, and password when prompted.

Credentials are stored locally so the daemon reconnects automatically after restarts.

Step 3 — Verify​

Confirm that the daemon is running and authenticated:

pandev status

Check that heartbeats are accumulating:

pandev time

You can also open Settings → Plugin → CLI plugin in the PanDev Metrics UI — your machine should appear with a recent heartbeat timestamp.

Useful commands​

pandev --help     # List every command the plugin exposes
pandev status     # Daemon health and auth state
pandev time       # CLI activity captured today
pandev login      # Re-authenticate

Update​

brew update && brew upgrade pandev-cli-plugin

Uninstall​

pandev-cli-plugin --uninstall
brew uninstall pandev-cli-plugin
brew untap pandev-metriks/pandev-cli

Troubleshooting​

pandev: command not found after installation

The Homebrew prefix may not be on your PATH. Add it to your shell init file:

echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.bashrc
exec bash -l
pandev status shows the daemon as not running

Restart the brew services or your terminal session, then re-run pandev login. If the issue persists, check journalctl --user -xe for daemon errors.

Self-signed certificate on on-prem server

Add your organisation's root CA to the system trust store:

# Debian / Ubuntu
sudo cp company-ca.crt /usr/local/share/ca-certificates/
sudo update-ca-certificates

# Fedora / RHEL
sudo cp company-ca.crt /etc/pki/ca-trust/source/anchors/
sudo update-ca-trust
No data in the dashboard after 30 minutes

Confirm three things:

  1. pandev status reports authenticated and running
  2. pandev time shows a non-zero value
  3. The user account used in pandev login matches the user account in the PanDev Metrics UI

FAQ​

Which distributions are supported?​

Any distribution where Homebrew on Linux runs — Ubuntu, Debian, Fedora, RHEL, Arch, openSUSE, and others. The plugin itself is a standard 64-bit Linux binary.

Do I need root / sudo?​

No. The daemon runs as your user; Homebrew on Linux does not require root for the install.

What shells are supported?​

bash, zsh, and fish. The plugin hooks into the shell on installation.

How do I switch to a different server URL?​

Run pandev login again and enter the new URL.