> 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/introduction.md).

# Introduction

{% hint style="danger" %}
**Configuration Manager compatibility**

2PXE Server 4.0 is not currently compatible with Microsoft Configuration Manager (ConfigMgr, formerly SCCM). If your environment relies on Configuration Manager PXE integration, remain on the previous 2PXE Server version. iPXE Anywhere Web Service does not restore the unsupported 2PXE integration.
{% endhint %}

iPXE Anywhere Web Service 4.0 is an optional web service component that extends the network boot capabilities of 2PXE Server. During the boot process, 2PXE can send requests to the web service, which uses PowerShell scripts to provide device-specific responses and perform additional actions.

The web service can also collect boot progress and status information in a SQL Server database, making it possible to monitor boot activity and build reports. Depending on your configuration, it can provide device authentication, custom boot logic, additional files and WinPE commands, and integration with StifleR.

{% hint style="warning" %}
**Upgrade requirements**

In-place upgrades from iPXE Anywhere Web Service 3.x to version 4.0 are not supported. Uninstall the existing version before installing 4.0, or perform a fresh installation on a new server. If you are upgrading 2PXE Server as well, direct upgrades to 2PXE Server 4.0 are not supported either. 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 %}

This documentation covers planning, installing, configuring, and operating iPXE Anywhere Web Service 4.0. It assumes that you use 2PXE Server to provide network boot services; the integration is configured on the 2PXE Server.

## Browse the documentation

### Start here

* [iPXE Anywhere Web Service Overview](/ipxe-ws/4.0/ipxe-anywhere-web-service-overview.md) — learn about the web service architecture and its main capabilities.

### What's New & Upgrades

* [Release Notes](/ipxe-ws/4.0/whats-new-and-upgrades/release-notes.md) — see what is included in iPXE Anywhere Web Service 4.0.
* [Upgrading to iPXE Anywhere Web Service 4.0](/ipxe-ws/4.0/whats-new-and-upgrades/upgrading-to-ipxe-ws-4.0.md) — review the requirements and steps for moving from version 3.x.

### Planning

* [Permissions](/ipxe-ws/4.0/planning/permissions.md) — understand the permissions required by the service account, including access to SQL Server.
* [Antivirus Exclusions](/ipxe-ws/4.0/planning/antivirus-exclusions.md) — review recommended antivirus exclusions for the service.

### Installation

* [iPXE Anywhere Web Service Install](/ipxe-ws/4.0/installation/ipxe-anywhere-web-service-install.md) — install the web service and configure its initial settings.
* [Unattended Installation](/ipxe-ws/4.0/installation/unattended-installation.md) — install the web service without using the interactive wizard.
* [Install iPXE Anywhere Reports](/ipxe-ws/4.0/installation/install-ipxe-anywhere-reports.md) — install the reporting components.

### Configuration

* [Configuring the iPXE Web Service](/ipxe-ws/4.0/configuration/configuring-the-ipxe-web-service.md) — configure ports, database access, HTTPS, scripts, and other service settings.
* [Integrating with 2PXE Server](/ipxe-ws/4.0/configuration/integrating-with-2pxe-server.md) — configure 2PXE to send boot and reporting requests to the web service.
* [Authentication](/ipxe-ws/4.0/configuration/authentication.md) — configure device authentication and approval.
* [Updating the Scripts Folder](/ipxe-ws/4.0/configuration/updating-the-scripts-folder.md) — manage the PowerShell scripts used to handle requests.
* [SQL Firewall Ports](/ipxe-ws/4.0/configuration/sql-firewall-ports.md) — configure the firewall rules required for SQL Server connectivity.

### Operations

* [Licensing](/ipxe-ws/4.0/operations/licensing.md) — renew or update the web service license.
* [Trigger PowerShell Script on Uploaded Logs](/ipxe-ws/4.0/operations/trigger-powershell-script-on-uploaded-logs.md) — run custom PowerShell actions when log uploads are received.

### Troubleshooting

* [Web Service Diagnostics](/ipxe-ws/4.0/troubleshooting/web-service-diagnostics.md) — investigate service events, logging, and configuration issues.
* [iPXE Boot Diagnostics](/ipxe-ws/4.0/troubleshooting/ipxe-boot-diagnostics.md) — troubleshoot iPXE boot failures using the iPXE console and network tests.


---

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