# Installation

In this section, you will learn how to install the .NET SDK in your project.

Before you can use this SDK in your .NET applications regardless of your environment, you need to install and import it into your project.
This guide will walk you through the process of installing and importing the SDK into your project.

## Install the SDK

- Create a new project using your favorite IDE (Visual Studio, JetBrains Rider, etc...)
- or use an existing template from the <code>dotnet new</code> command.

Once ready, add the SurrealDB SDK to your dependencies.

**.NET CLI**

```bash
dotnet add package SurrealDb.Net
```

**PackageReference**

```xml
<PackageReference Include="SurrealDb.Net" Version="1.0.0" />
```

<br />

Alternatively, you can install the SDK via the NuGet user interface provided in your IDE.
Here is an example within Visual Studio:

<img src="~/assets/img/dotnet-nuget-search.png" alt="Visual Studio NuGet Package Manager" />

## Initialise the SDK

The SDK's initialisation may vary depending on the context of your project.

The de facto initialisation method is to create and [consume a SurrealDbClient created manually](/docs/reference/dotnet/core/create-a-new-connection.md).
Most .NET projects provide a way to configure services using [Dependency Injection](/docs/reference/dotnet/core/dependency-injection.md), which is the recommended way to use the SDK in your application.