> 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/add-ons/packages/portal/installation.md).

# Installation

Detailed instructions on how to install and configure Portal into your Umbraco Commerce implementation.

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.](https://961659879-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP5oHq9zZ5dr8blWsnRJc%2Fuploads%2Fgit-blob-2f50160ef3f7124699e5517a54161dd4e54262e5%2Fucp_nuget_package_manager.png?alt=media)

## 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.](https://961659879-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP5oHq9zZ5dr8blWsnRJc%2Fuploads%2Fgit-blob-552aabdcb97bf0fff0a84eb98349bdf3b7ef9f6f%2Fucp_installer_dashboard.png?alt=media)

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.](https://961659879-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP5oHq9zZ5dr8blWsnRJc%2Fuploads%2Fgit-blob-6a6814d70c21a3cb3810430f50131017811eb2e0%2Fucp_install_modal_1.png?alt=media) ![The selected root node configured with a Umbraco Commerce store.](https://961659879-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP5oHq9zZ5dr8blWsnRJc%2Fuploads%2Fgit-blob-ab4bdbcf9f45a196037389e2c16ae2d89fb47fd5%2Fucp_install_modal_2.png?alt=media)

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.umbraco.com/umbraco-commerce/add-ons/packages/portal/installation.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.