Skip to main content

​
Requirements

The installer places files in system directories (/usr/local/bin/) and registers a system service (LaunchDaemon). The macOS administrator password is required for both installation and uninstallation.

​
Installation steps

​
Step 1: Generate an API key

Admina Tracker requires an organization-specific API key to send data.
  1. Log in to the Admina management console
  2. Go to Settings > Admina Tracker tab
  3. In the API Key section, click Generate new API key
  4. Copy the generated API key
The API key is only displayed when generated. Be sure to copy it and store it securely. If lost, you can issue a new key by clicking Recreate, but you will need to update all existing Admina Tracker installations.
Note down the Organization ID displayed on the same page. You will need it during installation.

​
Step 2: Download the installer

  1. Go to the Downloads section on the Settings > Admina Tracker tab
  2. Download the installer for your Mac:
    • macOS (Apple Silicon): For Macs with M1 / M2 / M3 / M4 chips
    • macOS (Intel): For Macs with Intel chips
To check your Mac’s chip, click Apple menu in the top-left corner > About This Mac. If Chip shows “Apple M1” or similar, it’s Apple Silicon. If Processor shows “Intel”, it’s Intel.

​
Step 3: Install

  1. Double-click the downloaded DMG file to open it
  2. Launch the Admina Tracker Installer application
  3. Enter the following on the installation screen:
    • API key: The API key generated in Step 1
    • Organization ID: The Organization ID shown in the management console
    • User email (optional): The user’s email address
  4. Click Install
  5. Enter your macOS administrator password to authorize
  6. Installation is complete when “Installation complete” is displayed
After installation, Admina Tracker automatically starts as a background service.

​
Verify installation

Run the following command in Terminal to verify that Admina Tracker is running:
If running correctly, the agent status and LaunchAgent state are displayed.

​
Installed resources

The following resources are created on the computer when Admina Tracker is installed.

​
Processes

​
Folders and files

​
LaunchAgent / LaunchDaemon

​
Uninstall

To uninstall Admina Tracker, use the same DMG file from installation.
  1. Double-click the DMG file to open it
  2. Launch Admina Tracker Installer
  3. If already installed, an Uninstall button is displayed
  4. Click Uninstall and enter your administrator password
  5. Choose whether to remove data and logs:
    • Keep data and logs: Keep data for a future reinstall
    • Remove data and logs: Permanently delete all data and logs
If you have lost the DMG file, you can download it again from the management console.

​
Auto-update

Admina Tracker supports automatic updates. When a new version becomes available, it updates automatically in the background. No manual update is required.

​
Troubleshooting

​
Installer shows “unidentified developer”

This message may appear on first launch due to macOS security settings. Go to System Settings > Privacy & Security and select “Open Anyway”.

​
API key errors

​
Admina Tracker has stopped

Admina Tracker is automatically started by macOS launchd.
  • Agent: Runs as a LaunchAgent and starts automatically on user login. No sudo required
  • Updater: Runs as a LaunchDaemon and starts automatically on system boot
When you restart your Mac or log out and log back in, Admina Tracker starts automatically upon login. To restart manually, run the following command in Terminal:

​
When support requests logs

Admina Tracker logs are stored in the directories below. If requested by support, send the relevant log files.
Last modified on July 28, 2026