> For the complete documentation index, see [llms.txt](https://docs.lithnet.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lithnet.io/ams/installation/upgrading-from-v3.0.md).

# Upgrading from Access Manager v3.0

Access Manager v3.1 is a platform release that moves the product to .NET 10. Access Manager v3.0 is supported until 10 November 2026, and v3.1 is supported until 14 November 2028. See the [product lifecycle page](/ams/help-and-support/lifecycle.md) for all support dates.

If you are upgrading from Access Manager v2, follow the [v2 upgrade guide](/ams/installation/upgrading-from-v2.md) instead.

## Upgrading the Access Manager Server

v3.1 is an in-place upgrade from v3.0. Download the v3.1 ['Access Manager Service' installer](/ams/installation/downloads.md) and run it over the top of the existing installation. The v3.0 configuration and database are compatible with v3.1, and no configuration changes are required. The installer automatically installs the required .NET 10 runtime components.

As a best practice precaution, we recommend taking a backup of the server and database before performing the upgrade.

If you run a load-balanced farm, all nodes must be updated at the same time. This applies to every Access Manager upgrade, as database schema changes can be introduced in any release.

## Upgrading the Access Manager Agents

The v3.1 agent uses the same server API as v3.0, so agents and the server can be upgraded in either order.

The v3.1 agents install over the top of the existing v3.0 agents on all platforms. Note the following operating system support changes before planning your agent rollout:

* The v3.1 Windows agent is available for x64 and arm64 only. Devices running 32-bit versions of Windows can continue to use the v3.0 agent until v3.0 reaches its end of support.
* The v3.1 agents for Linux and macOS are not available for Debian 11, Ubuntu 20.04, Fedora 35 through 41, or macOS 13, as these operating systems are not supported by .NET 10.

The agent installers are available from the [downloads page](/ams/installation/downloads.md). If you installed the Linux agent from the Lithnet package repository, v3.1 is published as an update to the existing package, so a standard package update upgrades the agent. See the installation guides for [Windows](/ams/installation/installing-the-access-manager-agent/installing-the-access-manager-agent-windows.md), [macOS](/ams/installation/installing-the-access-manager-agent/installing-the-access-manager-agent-macos.md), and [Linux](/ams/installation/installing-the-access-manager-agent/installing-the-access-manager-agent-linux.md) for deployment steps.


---

# 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.lithnet.io/ams/installation/upgrading-from-v3.0.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.