> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Admina Tracker (macOS solo)

> Step-by-step guide to installing Admina Tracker manually on macOS. Download the installer, configure your API key, and start collecting device data.

Follow these steps to manually install Admina Tracker on an individual Mac. Download the installer, configure your API key, and start collecting device data automatically.

## Installation steps

<h3 id="generate-api-key">
  Step 1: Generate an API key
</h3>

Admina Tracker requires an organization-specific API key to send data.

1. Log in to the Admina management console.
2. Open the **Settings** > **Admina Tracker** tab.
3. In the **API Key** section, click **Generate new API key**.
4. Copy the generated API key.

<Info>
  The API key is only displayed when generated. 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.
</Info>

Note down the organization ID shown in **Settings** > **API keys**. You will use it as the Organization ID.

<h3 id="download-installer">
  Step 2: Download the installer
</h3>

1. Open 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 processors

To download the latest version without going through the console:

* [macOS (Apple Silicon)](https://dl.itmc.i.moneyforward.com/admina-tracker/stable/mac-arm64/latest)
* [macOS (Intel)](https://dl.itmc.i.moneyforward.com/admina-tracker/stable/mac-x86/latest)

<Info>
  To check your Mac chip, open the **Apple menu** in the top-left corner > **About This Mac**. If **Chip** shows Apple M1 or similar, it is Apple Silicon. If **Processor** shows Intel, it is Intel.
</Info>

<h3 id="install">
  Step 3: Install
</h3>

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 displayed in the management console
   * `User email` (optional) — The user's email address
4. Click **Install**.
5. Enter your macOS administrator password to authorize the installation.
6. Installation is complete when "Installation complete" is displayed.

After installation is complete, Admina Tracker automatically starts as a background service.

<Info>
  Admina Tracker works with only `API key` and `Organization ID`, even if you leave `User email` empty. Admina identifies the device by its serial number and adds it to the device list. If a device with the same serial number already exists, Admina does not create a new device and uses the existing one.

  Application usage is still recorded in Admina. Usage is tied to the device instead of the user's email address. Each record includes the device's host name, or the serial number if the host name is unavailable. You can tell which device was used, but not which user used it.
</Info>

## Verify operation

Run the following command in Terminal to verify that Admina Tracker is running properly. It uses the full path so that it works right after installation.

```bash theme={null}
/usr/local/bin/admina-tracker status
```

If running properly, the agent status and LaunchAgent state are displayed.

## 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 — Delete all data and logs

If you choose **Keep data and logs**, the following folders and files remain.

| Path | Contents |
| - | - |
| `~/.admina-tracker/` | Data directory. It holds the SQLite database of collected data (`agent.db`) and the API key, Organization ID, and User email settings |
| `~/Library/Logs/AdminaTracker/` | Agent logs |
| `/Library/Logs/AdminaTracker/` | Updater logs |

If you reinstall with the data kept, the installer fills in the saved API key, Organization ID, and User email.

<Info>
  If you lost the DMG file, you can download it again from the management console.
</Info>

## Troubleshooting

### "Unidentified developer" warning

Due to macOS security settings, this message may appear on first launch. Open **System Settings** > **Privacy & Security** and select "Open Anyway".

For other issues, such as API key errors or service stoppages, see [Admina Tracker (macOS) Troubleshooting](/en/it-management/admina-tracker/install-mac#troubleshooting).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.