> For the complete documentation index, see [llms.txt](https://help.nightfall.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.nightfall.ai/data-exfiltration-prevention/exfiltration_endpoint/install-nightfall-ai-agent-for-windows-os/manual-installation.md).

# Manual Installation

Learn how to install the Nightfall agent on Microsoft Windows OS manually.

## Overview

This document outlines the steps to manually deploy the Nightfall AI Agent on a Windows device.

## Prerequisites

* Ensure that Windows endpoint has been enabled on your Nightfall tenant.
  * Download the Nightfall AI Agent `NightfallAgent.msi` file from Nightfall.
    * Download NightfallAgent.msi from [Nightfall portal](https://app.nightfall.ai/endpoint) to a local folder on the target machine
      * Integrations -> Endpoint Windows -> Manage -> Download Package -> Download Package For Windows

<figure><img src="https://3764378997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZeqNSdo8J8cLJPU3Gs5M%2Fuploads%2FZk9sbeg78qRN9bt9c4NH%2Fimage.png?alt=media&amp;token=f23e6e3b-50f1-4bbc-953e-ca1399451fc2" alt=""><figcaption></figcaption></figure>

* Navigate to <https://app.nightfall.ai/policies/setup> > Exfiltration > Endpoint - (optional)

## Deployment Steps

1. Copy downloaded `NightfallAgent.msi` to a folder on a target machine.
2. Run the Installer:
   1. Launch `CMD` as an Administrator

<figure><img src="https://3764378997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZeqNSdo8J8cLJPU3Gs5M%2Fuploads%2FilyBeNnLZY7mrShZCJRO%2Fimage.png?alt=media&amp;token=87494cbf-8d72-43cb-9065-e4ab25a1e97e" alt=""><figcaption></figcaption></figure>

b. Navigate to the folder where NightfallAgent.msi is downloaded to.

&#x20;     i. `cd C:\\users\\<username>\\Downloads\\` update the above accordingly.

c. Copy the installation command from [Nightfall Portal](https://app.nightfall.ai/endpoint).

&#x20;    i. **Note** : this includes the necessary command line parameters for the agent to communicate with                                 Nightfall

&#x20;     ii. Integrations -> Endpoint Windows -> Manage -> Download Package -> 'To install, run the command as admin.

<figure><img src="https://3764378997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZeqNSdo8J8cLJPU3Gs5M%2Fuploads%2FICiu8q7Ca7XjX4uXDTzQ%2Fimage.png?alt=media&amp;token=e4e2a5fa-6d3f-4e3b-9baf-68c1ace85984" alt=""><figcaption></figcaption></figure>

d. Paste the `msiexec` installation command copied from the above step to `cmd` and press Enter key.

e. Installation should start in silent mode.

<figure><img src="https://3764378997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZeqNSdo8J8cLJPU3Gs5M%2Fuploads%2FW7h06OGaWf6KgFWHb617%2F11.webp?alt=media&amp;token=4c763838-1329-420e-886e-3c5f6142fc5a" alt=""><figcaption></figcaption></figure>

3. Verify Installation
   1. Once installation is complete, check if the agent is running:
      1. Open **Task Manager** (`Ctrl + Shift + Esc`).
      2. Look for the **Nightfall Agent** & **NightfallUI** processes under the **Processes** tab.

<figure><img src="https://3764378997-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZeqNSdo8J8cLJPU3Gs5M%2Fuploads%2FBeInqJwSJgwbgNjniQrW%2F2.webp?alt=media&amp;token=05d00f8d-0dac-4cf5-a135-f5a6757c3f22" alt=""><figcaption></figcaption></figure>

b. Confirm the Nightfall agent is configured to your Nightfall tenant

&#x20;    i. On the windows machine:

&#x20;           1\. Double-click the Nightfall agent icon in the status bar.

&#x20;           2\. The displayed UUID should match your Nightfall tenant UUID located under <https://app.nightfall.ai/settings/>

&#x20;     ii. On the Nightfall console:

&#x20;          1\. The newly configured device should be listed under <https://app.nightfall.ai/endpoint>

## Conclusion

The Nightfall AI Agent should now be successfully installed, running on your Windows machine, and connected to your Nightfall tenant. If you run into any issues, please contact Nightfall AI support.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.nightfall.ai/data-exfiltration-prevention/exfiltration_endpoint/install-nightfall-ai-agent-for-windows-os/manual-installation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.