Installation Guide

Step-by-step instructions for manually installing the Pult Agent on macOS, Windows, and Linux.

This guide covers manual installation of the Pult Agent. For automated deployment via MDM, see MDM Deployment.

Download

Download the latest Pult Agent installer for your platform from the link provided by your Pult administrator or from the Pult Dashboard.

Open the downloaded .dmg file.
Drag Pult Agent into the Applications folder.
Launch Pult Agent from the Applications folder (or Spotlight).
The Pult Agent icon (P) appears in the menu bar.
Click the icon and select Sign In.
Your browser opens -- sign in with your Pult account.
After authentication, the agent is linked to your account. The tray menu shows your sign-in status.

Drag Pult Agent into the Applications folder

Pult Agent tray menu on macOS

Run the downloaded .msi installer.
Follow the installation wizard. The default installation path is C:\Program Files\Pult Agent.
After installation, the Pult Agent starts automatically (or starts on next login).
The Pult Agent icon (P) appears in the system tray (notification area).
Click the icon and select Sign In.
Your browser opens -- sign in with your Pult account.
After authentication, the agent is linked to your account.

Linux support is currently available for x86_64 architecture only. ARM-based devices are not supported.

sudo dpkg -i pult-agent_*.deb

sudo apt-get install -f

Launch the Pult Agent from your application launcher or run pult-agent from the terminal.
Click the tray icon and select Sign In to authenticate via the browser.

After signing in:

Click the Pult Agent tray icon.
If you're connected to a configured office network, the menu shows your current office location name.
In the Pult Dashboard, navigate to Presence Dashboard -- your presence should appear within a few minutes.

Sign-in is a one-time process. The agent stores your credentials securely in the OS keychain (macOS) or Credential Manager (Windows).
The agent refreshes your access token automatically -- no periodic re-authentication is needed.
If your token expires or is revoked, the agent will prompt you to sign in again.

Issue	Solution
Tray icon (P) is not visible	Make sure the app is running. On Windows, check the hidden icons area in the taskbar. On macOS, check System Settings for menu bar overflow.
"Unknown Office Location" in tray	Your current network doesn't match any configured presence location. Verify the presence location subnets include your office's public IP.
Sign-in page doesn't open	Check that your default browser is working and that `app.pult.com` is reachable.

For more detailed troubleshooting, see the Troubleshooting page.