> For the complete documentation index, see [llms.txt](https://docs.appstrategy.com/apprules-r-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.appstrategy.com/apprules-r-documentation/platform/self-hosting/software-installation/installation-prerequisites.md).

# Installation Prerequisites

**System Requirements**

To run appRules, your computer must meet the following criteria:

* **OS** — Windows 10/11, or Windows Server 2019/2022/2025
* [**.NET 10 Desktop Runtime**](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) — Required. Provides both the base .NET runtime and the Windows Desktop libraries used by the portal UI.
* [**ASP.NET Core 10 Runtime**](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) — Required. Included in the .NET 10 Hosting Bundle.
* **IIS 10 or later** — Optional; appRules includes its own web server (see appRulesPortal Settings).

The appRules installer detects missing runtimes and will offer to download and install them.

**Installation Notes**

* Because of UAC and file permissions in Windows, the installer must be run **as Administrator**.
* IIS and/or the appRulesPortal Kestrel server each require one open port (default 80 and/or 8080). appRules.WebApiService requires an additional port (default 8082). Port 443 must be open if using SSL.
* The caching engine (GarnetServer) requires port 6379 to be open.

**.NET Runtime Notes**

appRules no longer requires .NET Framework 4.8.1. All four components — appRulesPortal, appRules.WebApiService, appRules.SchedulerService and appRules.CachingService — run on .NET 10, as does the GarnetServer caching engine.

On a clean machine, install both of the following (x64):

1. **.NET 10 Hosting Bundle** — base .NET runtime, ASP.NET Core runtime, and the IIS hosting module.
2. **.NET 10 Desktop Runtime** — adds `Microsoft.WindowsDesktop.App`, required by the Wisej.NET UI framework.

.NET 10 is a Long Term Support (LTS) release, supported by Microsoft until November 2028.

**Verifying the installed runtimes**

Open a command prompt and run:

```
dotnet --list-runtimes
```

The output must contain a 10.x entry for each of the following:

```
Microsoft.AspNetCore.App 10.0.x
Microsoft.NETCore.App 10.0.x
Microsoft.WindowsDesktop.App 10.0.x
```

If `dotnet` is not recognised, no .NET runtime is installed yet.

\
 


---

# 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://docs.appstrategy.com/apprules-r-documentation/platform/self-hosting/software-installation/installation-prerequisites.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.