> 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.appstrategy.com/apprules-r-documentation/platform/self-hosting/software-installation/installation-prerequisites.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.