> For the complete documentation index, see [llms.txt](https://documentation.2pintsoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.2pintsoftware.com/ipxe-ws/4.0/installation/ipxe-anywhere-web-service-install.md).

# iPXE Anywhere Web Service Install

{% hint style="warning" %}
In-place upgrades from iPXE Anywhere Web Service 3.x are not supported. Uninstall the existing version before installing 4.0. See [Upgrading to iPXE Anywhere Web Service 4.0](/ipxe-ws/4.0/whats-new-and-upgrades/upgrading-to-ipxe-ws-4.0.md).
{% endhint %}

## Prerequisites

* Windows Server 2019 (or above).
* Both of the following Microsoft .NET 10 components (10.0.14 or later), available from the [.NET 10.0 download page](https://dotnet.microsoft.com/download/dotnet/10.0):
  * .NET Runtime 10.0.14
  * ASP.NET Core Runtime 10.0.14
* Microsoft .NET Framework 4.8 or later, which is required by the **Configure iPXE WS** configuration editor. It is included with Windows Server 2022 and later; on Windows Server 2019 it must be [installed separately](https://dotnet.microsoft.com/download/dotnet-framework/net48).
* The user account running the installation must be a local administrator on the server. The installer does not connect to SQL Server; the service creates the database when it first starts, so the service's account needs SQL Server permissions instead (see [Permissions](/ipxe-ws/4.0/planning/permissions.md)).
* License key (optional at this point)
* SQL Database - This database stores info about PXE booted computers and their capabilities. Traffic to this database is very small and, if necessary, it may be hosted on SQL Express. The SQL Database does not have to be installed on the same server as the iPXE Anywhere Web Service, but the service requires access to and permissions on the SQL Server in order to create the database and also to interact with it. See the [Permissions](/ipxe-ws/4.0/planning/permissions.md) page for more information.

## Installation

From an Elevated Command prompt launch **TwoPint.iPXEAnywhere.WebService.Installer64.msi**.

At the "Welcome" screen, feel welcomed, and then click **Next**.

<figure><img src="https://1290804800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPMTFuBb6yV8Wq1KUzxo%2Fuploads%2FDhJftvvuL7hBfHvdnNYV%2Fimage.png?alt=media&amp;token=b8fe136a-062b-447d-a78e-12e29c47d2e2" alt=""><figcaption></figcaption></figure>

At the "End-User License Agreement" screen, once you have reviewed the EULA, check the box:\
**I accept the terms in the License Agreement**, and then click **Next**.

<figure><img src="https://1290804800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPMTFuBb6yV8Wq1KUzxo%2Fuploads%2FUrujZh7AqQgmuQOepn5o%2Fimage.png?alt=media&amp;token=b1a16643-e671-49ea-9cac-51c6ca522e74" alt=""><figcaption></figcaption></figure>

At the "Destination Folder" screen, enter the path in which the iPXE Anywhere program files should be installed and then click **Next**.

<figure><img src="https://1290804800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPMTFuBb6yV8Wq1KUzxo%2Fuploads%2FxJgLGjVLtlXOBHdkXxz4%2Fimage.png?alt=media&amp;token=79e09ef4-4839-467d-8a18-53e635eaa725" alt=""><figcaption></figcaption></figure>

At the "Ready to install..." screen, click **Install** to begin the installation.

<figure><img src="https://1290804800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPMTFuBb6yV8Wq1KUzxo%2Fuploads%2Fj29Vkx4q4p2RqQKIZx5T%2Fimage.png?alt=media&amp;token=7433a79a-12d1-4e2d-9016-fa99e2eda785" alt=""><figcaption></figcaption></figure>

At the "Completed" screen, the installation wizard is complete. Leave the "Launch Configuration Editor" checkbox checked and click **Finish**.

<figure><img src="https://1290804800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPMTFuBb6yV8Wq1KUzxo%2Fuploads%2F0gLe4rytvjhbQ2xQggNH%2Fimage.png?alt=media&amp;token=94a80025-1e99-4398-bbfa-b43c3de1614d" alt=""><figcaption></figcaption></figure>

The **Configure iPXE WS** configuration editor opens automatically. Enter the license key and the database settings, and review the other settings (see [Configuring the iPXE Web Service](/ipxe-ws/4.0/configuration/configuring-the-ipxe-web-service.md)). Click **Verify**, and then **Save**. The installer sets the **2Pint Software iPXE Anywhere Web Service** service to **Manual** startup and does not start it; saving the configuration in the editor sets it to **Automatic** startup and starts it.

To install the web service silently, see [Unattended Installation](/ipxe-ws/4.0/installation/unattended-installation.md).

The installer includes an initial set of scripts in the **Templates** folder, which the service copies to the **Scripts** folder inside the installation folder (by default **C:\Program Files\2Pint Software\iPXE AnywhereWS\Scripts**) the first time it starts. To get newer script examples, see [Updating the Scripts Folder](/ipxe-ws/4.0/configuration/updating-the-scripts-folder.md).


---

# 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://documentation.2pintsoftware.com/ipxe-ws/4.0/installation/ipxe-anywhere-web-service-install.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.
