Agent installation options

Before installing

Choose the package for your operating system and processor: Linux, macOS 14 or newer, Windows 11 or Windows Server 2022 or newer, with x64 or ARM64. npm installation needs Node.js 22 or newer; native downloads do not. You need permission on your own machine to install a background service. Linux without systemd can use foreground mode.

Install and connect

Open Servers, choose Linux / macOS or Windows and copy the installation command. Run it on your server. The latest released agent, its system service, device key and selected profile are configured automatically; no browser confirmation is needed on the server. Your operating system may ask for administrator approval.

Alternatively, install the CLI with npm or a native download and use the following commands for browser-assisted pairing.

npm install -g metribeacon
metribeacon setup
metribeacon status
# Alternatives: pnpm add -g metribeacon; yarn global add metribeacon

Keep access private

Connecting to an existing account does not create another account. Setup asks separately for device data access and CLI/MCP management access. Keep identity files and keys private and out of command arguments, logs and repositories. A connection code expires after ten minutes; restart setup if it expired.

Check, update or remove

Use status for the current state, doctor for diagnostics and logs for recent messages. agent start, stop and restart control the service on your machine. Use update or your package manager to update the program. agent uninstall removes the managed service; keys, configuration and pending data remain unless you explicitly choose --purge. For an unfinished connection you want to discard, use --reset-link before starting again.