> ## 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.

# Installing Admina Tracker (macOS) — Solo Setup

> Install Admina Tracker on macOS. Download the installer from the management console, configure your API key, and start collecting device data automatically.

## Requirements

| Item         | Requirement                                         |
| ------------ | --------------------------------------------------- |
| OS           | macOS 10.15 (Catalina) or later                     |
| Architecture | Apple Silicon (M1 or later) or Intel                |
| Permissions  | Administrator password required during installation |
| Network      | Internet connection (for data transmission)         |

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

<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. Go to **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. 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.
</Info>

Note down the **Organization ID** displayed on the same page. You will need it during installation.

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

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

<Info>
  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.
</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 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:

```bash theme={null}
admina-tracker status
```

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

| Process                         | Description                                             |
| ------------------------------- | ------------------------------------------------------- |
| `admina-tracker daemon`         | Agent that collects and sends device data (LaunchAgent) |
| `admina-tracker-updater daemon` | Process that manages automatic updates (LaunchDaemon)   |

### Folders and files

| Path                                    | Description                        |
| --------------------------------------- | ---------------------------------- |
| `/usr/local/bin/admina-tracker`         | Agent binary                       |
| `/usr/local/bin/admina-tracker-updater` | Updater binary                     |
| `~/.admina-tracker/`                    | Data directory                     |
| `~/.admina-tracker/agent.db`            | SQLite database for collected data |
| `~/Library/Logs/AdminaTracker/`         | Agent log directory                |
| `/Library/Logs/AdminaTracker/`          | Updater log directory              |

### LaunchAgent / LaunchDaemon

| plist                                                                  | Label                                     | Type                                 |
| ---------------------------------------------------------------------- | ----------------------------------------- | ------------------------------------ |
| `~/Library/LaunchAgents/com.moneyforward.admina.tracker.plist`         | `com.moneyforward.admina.tracker`         | LaunchAgent (starts at user login)   |
| `/Library/LaunchDaemons/com.moneyforward.admina.tracker.updater.plist` | `com.moneyforward.admina.tracker.updater` | LaunchDaemon (starts at system boot) |

## 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

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

## 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

| Error message              | Cause                         | Solution                                         |
| -------------------------- | ----------------------------- | ------------------------------------------------ |
| api\_key is not configured | API key not set               | Re-enter the API key using the installer         |
| Invalid API key (401)      | API key is invalid or expired | Regenerate the API key in the management console |

### 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:

```bash theme={null}
admina-tracker restart
```

### When support requests logs

Admina Tracker logs are stored in the directories below. If requested by support, send the relevant log files.

| Type         | Path                            |
| ------------ | ------------------------------- |
| Agent logs   | `~/Library/Logs/AdminaTracker/` |
| Updater logs | `/Library/Logs/AdminaTracker/`  |