> ## 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 (Windows) — Solo Setup

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

## Requirements

| Item        | Requirement                                               |
| ----------- | --------------------------------------------------------- |
| OS          | Windows 10 / 11 (x64)                                     |
| Permissions | No administrator privileges required (installed per user) |
| Network     | Internet connection (for data transmission)               |

Admina Tracker is installed per user, so Windows administrator privileges (UAC elevation) are not required. For organization-wide deployment, end users can run the installer with their own account.

## 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 **Windows (x64)** installer

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

1. Run the downloaded installer
2. Select the installation folder (the default is fine)
3. Enter the following on the next 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. Installation is complete when "Installation complete" is displayed

After installation, Admina Tracker starts in the background automatically. It starts when you log in to Windows, so no manual launch is needed.

## Verify installation

Run the following command in Command Prompt or PowerShell to verify that Admina Tracker is running:

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

If running correctly, the agent status is displayed.

<Info>
  After initial installation, open a new terminal before running the command.
</Info>

## Installed resources

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

### Processes

| Process                      | Description                               |
| ---------------------------- | ----------------------------------------- |
| `admina-tracker.exe`         | Agent that collects and sends device data |
| `admina-tracker-updater.exe` | Process that manages automatic updates    |

Both run as background processes under the user's account. They start automatically when you log in to Windows.

### Folders and files

| Path                                                      | Description                        |
| --------------------------------------------------------- | ---------------------------------- |
| `%LOCALAPPDATA%\AdminaTracker\`                           | Installation directory             |
| `%LOCALAPPDATA%\AdminaTracker\admina-tracker.exe`         | Agent binary                       |
| `%LOCALAPPDATA%\AdminaTracker\admina-tracker-updater.exe` | Updater binary                     |
| `%LOCALAPPDATA%\AdminaTracker\data\agent.db`              | SQLite database for collected data |
| `%LOCALAPPDATA%\AdminaTracker\logs\`                      | Log file directory                 |

### Registry

| Key                                                  | Value name             | Purpose                     |
| ---------------------------------------------------- | ---------------------- | --------------------------- |
| `HKCU\Software\Microsoft\Windows\CurrentVersion\Run` | `AdminaTracker`        | Auto-start agent at logon   |
| `HKCU\Software\Microsoft\Windows\CurrentVersion\Run` | `AdminaTrackerUpdater` | Auto-start updater at logon |
| `HKCU\Environment`                                   | `Path` (appended)      | Command-line access         |

## Uninstall

### Uninstall from **Apps & features**

1. Open **Settings** > **Apps** > **Apps & features**
2. Find **Admina Tracker** in the list
3. Click **Uninstall**
4. Choose whether to remove data and logs:
   * **Yes**: Remove all data and logs
   * **No**: Keep data and logs for a future reinstall
5. Uninstallation is complete when "Admina Tracker was successfully removed from your computer." is displayed

<Info>
  To carry over your previous settings when reinstalling, keep the data. If data is kept, the API key and Organization ID are filled in automatically during reinstall.
</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

### "Windows protected your PC" is displayed

Windows SmartScreen may display this message on first launch. Click **More info**, then select **Run anyway**.

### API key errors

| Error message              | Cause                         | Solution                                         |
| -------------------------- | ----------------------------- | ------------------------------------------------ |
| api\_key is not configured | API key not set               | Run the installer again and enter the API key    |
| 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 via Windows registry (`HKCU\Software\Microsoft\Windows\CurrentVersion\Run`).

* **Both the agent and updater**: Start automatically when you log on to Windows. No administrator privileges required

When you restart your PC or sign out and sign back in, Admina Tracker starts automatically upon logon.

To restart manually, run the following command in Command Prompt or PowerShell:

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

### When support requests logs

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

| Type          | Path                                 |
| ------------- | ------------------------------------ |
| Log directory | `%LOCALAPPDATA%\AdminaTracker\logs\` |