> For the complete documentation index, see [llms.txt](https://docs.umbraco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.umbraco.com/umbraco-commerce-packages/portal/installation.md).

# Installation

The Portal package can be installed directly into your project's code base using NuGet packages.

## NuGet Package Installation

To install the Umbraco Commerce Portal package via NuGet run the following command directly in the NuGet Manager Console window in Visual Studio:

```bash
PM> Install-Package Umbraco.Commerce.Portal
```

Alternatively, you can also find and install the NuGet package via the NuGet Package Manager.

![Installing Umbraco Commerce Portal via the NuGet Package Manager.](/files/SgNAlAV2XtXuS2l9tAXO)

## Content Installation

When the Portal package is installed, all relevant database configurations automatically occur via Umbraco Migrations. There are a series of content creation steps that need to be triggered manually as these types of migrations are not supported by Umbraco.

To install the relevant Portal content follow these steps:

1. Access the Umbraco CMS backoffice.
2. Navigate to the **Settings** section.
3. Locate the **Portal Dashboard**.

![The Portal Dashboard in the Settings section of the Umbraco backoffice.](/files/M7BMyvwHsUtwRPxLR6dT)

4. Click the **Install** button.
5. Select your site's root node which is configured with a Umbraco Commerce store.
6. Click **Install**.

![The dialog that appears when installing content through the Portal dashboard.](/files/xmGIihKbQ3A8Xmjfz1RS) ![The selected root node configured with a Umbraco Commerce store.](/files/ykXusDOmmjkePyMj9IBj)

During this install, Umbraco Commerce Portal will perform the following tasks:

* [x] Configure the Umbraco Commerce store with custom Umbraco Commerce Portal email templates for confirming portal account and reset password.
* [x] Create the Umbraco Commerce Portal Member Group (`Commerce Portal`), Member Type (`Umbraco Commerce Portal Member`), and Data Type (`Umbraco Commerce Portal Country Picker`).
* [x] Create the Umbraco Commerce Portal Document Types:
  * Portal Container
    * Login, Register and Reset Password pages
    * Portal Management pages:
      * My Account
      * Order History
      * Order Details
* [x] Create the Umbraco Commerce Portal content nodes beneath the select site root node (unpublished).
* [x] Configure the Umbraco Commerce Portal Management Pages public access for members part of the `Commerce Portal` group.

## Upgrading

{% hint style="info" %}
Before upgrading, it is always advisable to take a complete backup of your site/database.
{% endhint %}

The Portal package uses a combination of database migrations and a manual install dashboard for both installs and upgrades. To upgrade, install the latest version over the existing package and complete the installation 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:

```
GET https://docs.umbraco.com/umbraco-commerce-packages/portal/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.