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

# Admina Tracker のインストール（Windows）ソロセットアップ

> Admina Tracker を Windows にインストールする手順です。管理画面からインストーラーをダウンロードし、API キーを設定してデバイス情報の自動収集を開始します。

## 動作要件

| 項目     | 要件                      |
| ------ | ----------------------- |
| OS     | Windows 10 / 11（x64）    |
| 権限     | 管理者権限は不要（ユーザー単位でインストール） |
| ネットワーク | インターネット接続（データ送信用）       |

Admina Tracker はユーザーごとにインストールされるため、Windows の管理者権限（UAC の昇格）は不要です。IT 管理者による全社展開でも、エンドユーザーが自身のアカウントでインストーラーを実行できます。

## インストール手順

<h3 id="generate-api-key">
  ステップ 1: API キーを生成する
</h3>

Admina Tracker がデータを送信するには、組織ごとの API キーが必要です。

1. Admina の管理画面にログインします
2. **設定** > **Admina Tracker** タブを開きます
3. **API キー** セクションで **新しい API キーを生成する** をクリックします
4. 生成された API キーをコピーします

<Info>
  API キーは生成時にのみ表示されます。必ずコピーして安全な場所に保管してください。紛失した場合は **再生成** で新しいキーを発行できますが、既存のすべての Admina Tracker で更新が必要になります。
</Info>

同じ画面に表示される **Organization ID** もメモしておいてください。インストール時に入力します。

<h3 id="download-installer">
  ステップ 2: インストーラーをダウンロードする
</h3>

1. **設定** > **Admina Tracker** タブの **ダウンロード** セクションを開きます
2. **Windows（x64）** のインストーラーをダウンロードします

<h3 id="install">
  ステップ 3: インストールする
</h3>

1. ダウンロードしたインストーラーを実行します
2. インストール先のフォルダを選択します（デフォルトのままで問題ありません）
3. 次の画面で以下を入力します
   * `API key` — ステップ 1 で生成した API キー
   * `Organization ID` — 管理画面に表示されている Organization ID
   * `User email`（任意） — 利用者のメールアドレス
4. **Install** をクリックします
5. 「Installation complete」と表示されたら完了です

インストールが完了すると、Admina Tracker はバックグラウンドで自動的に起動します。Windows にログインすると自動的に開始されるため、手動で起動する必要はありません。

## 動作確認

コマンドプロンプトまたは PowerShell で以下のコマンドを実行して、Admina Tracker が正常に動作していることを確認できます。

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

正常に動作している場合、エージェントのステータスが表示されます。

<Info>
  インストール直後は、新しいターミナルを開いてからコマンドを実行してください。
</Info>

## インストールされるリソース

Admina Tracker のインストールにより、以下のリソースがコンピューターに作成されます。

### プロセス

| プロセス                         | 説明                    |
| ---------------------------- | --------------------- |
| `admina-tracker.exe`         | デバイス情報の収集・送信を行うエージェント |
| `admina-tracker-updater.exe` | 自動アップデートを管理するプロセス     |

いずれもユーザー権限で動作するバックグラウンドプロセスです。Windows にログインすると自動的に開始されます。

### フォルダとファイル

| パス                                                        | 内容                   |
| --------------------------------------------------------- | -------------------- |
| `%LOCALAPPDATA%\AdminaTracker\`                           | インストールディレクトリ         |
| `%LOCALAPPDATA%\AdminaTracker\admina-tracker.exe`         | エージェント本体             |
| `%LOCALAPPDATA%\AdminaTracker\admina-tracker-updater.exe` | アップデーター              |
| `%LOCALAPPDATA%\AdminaTracker\data\agent.db`              | 収集データの SQLite データベース |
| `%LOCALAPPDATA%\AdminaTracker\logs\`                      | ログファイルの保存先           |

### レジストリ

| キー                                                   | 値の名前                   | 用途            |
| ---------------------------------------------------- | ---------------------- | ------------- |
| `HKCU\Software\Microsoft\Windows\CurrentVersion\Run` | `AdminaTracker`        | ログオン時の自動起動    |
| `HKCU\Software\Microsoft\Windows\CurrentVersion\Run` | `AdminaTrackerUpdater` | アップデーターの自動起動  |
| `HKCU\Environment`                                   | `Path`（追加）             | コマンドラインからの実行用 |

## アンインストール

### アプリと機能からアンインストールする

1. **設定** > **アプリ** > **アプリと機能** を開きます
2. 一覧から **Admina Tracker** を探します
3. **アンインストール** をクリックします
4. データとログの削除を選択します
   * 「はい」を選ぶとデータとログをすべて削除します
   * 「いいえ」を選ぶとデータとログを残して再インストールに備えます
5. 「Admina Tracker was successfully removed from your computer.」と表示されたら完了です

<Info>
  再インストール時に以前の設定を引き継ぎたい場合は、データを残すことをおすすめします。データを残した場合、再インストール時に API キーや Organization ID が自動的に入力されます。
</Info>

## 自動アップデート

Admina Tracker は自動アップデートに対応しています。新しいバージョンが利用可能になると、バックグラウンドで自動的に更新されます。手動でのアップデート作業は不要です。

## トラブルシューティング

### 「WindowsによってPCが保護されました」と表示される場合

Windows SmartScreen により、インストーラーの初回実行時にこのメッセージを表示することがあります。**詳細情報** をクリックし、**実行** を選択してください。

### API キーのエラーが表示される

| エラーメッセージ                   | 原因               | 対処法                            |
| -------------------------- | ---------------- | ------------------------------ |
| api\_key is not configured | API キーが設定されていない  | インストーラーを再度実行して API キーを入力してください |
| Invalid API key (401)      | API キーが無効または期限切れ | 管理画面で API キーを再生成してください         |

### Admina Tracker が停止している

Admina Tracker は Windows のレジストリ（`HKCU\Software\Microsoft\Windows\CurrentVersion\Run`）によって自動起動されます。

* エージェント本体・アップデーターともに Windows へのログオン時に自動起動します。管理者権限は不要です

PC を再起動した場合やサインアウト・サインインした場合も、ユーザーがログオンすると自動的に開始されます。

手動で再起動する場合は、コマンドプロンプトまたは PowerShell で以下のコマンドを実行してください。

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

### サポートからログの取得を依頼されたら

Admina Tracker のログは以下のディレクトリに保存されています。サポートから依頼があった場合は、該当するログファイルを送付してください。

| 種別       | パス                                   |
| -------- | ------------------------------------ |
| ログディレクトリ | `%LOCALAPPDATA%\AdminaTracker\logs\` |