# Getting Started

## **Overview** <a href="#id-2p4ylpspjcft" id="id-2p4ylpspjcft"></a>

The main benefits of using the Database Extension Kit plugin are:

* management of an external data store that your site uses, such as an external relational database
* storing huge amounts of data in an effective way
* user friendly administration which fits perfectly with Umbraco UI
* Avoiding common database pitfalls in Umbraco, such as volatile data, expensive lookups on content items and content tables reindexing

Storing volatile data in Umbraco content items can lead to serious performance issues and is listed among Umbraco anti-patterns: <https://docs.umbraco.com/umbraco-cms/reference/common-pitfalls#using-umbraco-content-items-for-volatile-data>

The best way to address this is to keep the data which is either volatile or large in quantity, in an external data store. With the Database Extension Kit, you can create an external data store based on the relational database which Umbraco already uses by extending the database with the data entities you need.

The entities are created and managed in a straight-forward and user-friendly way which fits perfectly with Umbraco UI and the user experience your administrative users already have.

This documentation is aimed at Umbraco developers and administrative users who already possess a working knowledge and understanding of Umbraco concepts.

**System requirements**

Umbraco 10.0+, Microsoft SQL Server database

## **Installation** <a href="#cmck12fe46s1" id="cmck12fe46s1"></a>

#### **Command line** <a href="#eao9qt8i2f3t" id="eao9qt8i2f3t"></a>

Database Extension Kit can be installed using the NuGet Package Manager, by running the following command at the command line prompt in your web project folder.

dotnet add package DatabaseExtensionKit

#### **Visual Studio** <a href="#lt9sjlaqmyhz" id="lt9sjlaqmyhz"></a>

In Visual Studio, you can use the NuGet Package Manager GUI from the Tools menu, by selecting Tools > NuGet Package Manager > Manage NuGet Packages for Solution.

Alternatively, you can run the following command from the NuGet Package Manager Console:

Install-Package DatabaseExtensionKit

## **Upgrading** <a href="#gir7vld1w8tr" id="gir7vld1w8tr"></a>

#### **Command line** <a href="#kf4ergg0ihrp" id="kf4ergg0ihrp"></a>

Database Extension Kit can be upgraded to the latest version by running the following command at the command line prompt from your web project folder.

dotnet add package DatabaseExtensionKit

#### **Visual Studio** <a href="#rv06r2wogdju" id="rv06r2wogdju"></a>

In Visual Studio, you can use the NuGet Package Manager GUI from the Tools menu, by selecting Tools > NuGet Package Manager > Manage NuGet Packages for Solution.

## **Licensing** <a href="#id-6wa8t0w13vna" id="id-6wa8t0w13vna"></a>

Database Extension Kit comes in two flavors:

1. Free edition which comes with the community support and limited number of entities in your data model
2. Premium edition which comes with our enterprise grade support, unlimited entities in your data model and automatic model generation

For details related to pricing of premium edition, please visit our pricing page: <https://www.dbextensionkit.com/pricing>

## **Configuration** <a href="#qn3zm9oh6cm7" id="qn3zm9oh6cm7"></a>

When the plugin is successfully installed and configured, two new sections will appear in Umbraco backoffice: Database Extension Kit and Database Extension Kit Admin.

To enable them, you need to allow access to the sections for your back-office users. This is done via the Users section. For each user group, go to Sections and add Database Extension Kit and Database Extension Kit Admin from the list of available sections.

After refreshing the back-office, the new sections will appear in the main menu.


---

# Agent Instructions: 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://hexxu-services-ltd.gitbook.io/database-extension-kit-documentation/getting-started.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.
