# Hosting


NServiceBus is a library at its core so that it can be hosted in any .NET process.

There are several approaches to hosting.

## Hosting with Microsoft.Extensions.Hosting

The [Microsoft Generic Host](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/host/generic-host) is the standard way to host NServiceBus in modern .NET applications. Endpoints are registered on `IServiceCollection` using [`AddNServiceBusEndpoint`](/nservicebus/hosting/core-hosting.md).

For existing applications, [NServiceBus.Extensions.Hosting](/nservicebus/hosting/extensions-hosting.md) and the `UseNServiceBus` integration remain supported.



### Windows Service hosting

A [Windows Service](https://learn.microsoft.com/en-us/dotnet/framework/windows-services/introduction-to-windows-service-applications) is a common way to host NServiceBus in Windows.

Related:
 * [Generic host as Windows Service](/samples/hosting/generic-host/index.md)
 * [Generate a Windows Service project using `dotnet new`](/nservicebus/dotnet-templates/index.md)
 * [Windows Service installation](windows-service.md)

### Docker container hosting

An endpoint can be hosted inside a [Docker](https://www.docker.com/) container.

Related:
 * [Docker container host](/nservicebus/hosting/docker-host/index.md)
 * [Generate a Docker-hosted endpoint project with `dotnet new`](/nservicebus/dotnet-templates/index.md)
 * [Hosting endpoints in Docker Linux containers](/samples/hosting/docker/index.md)
 * [Generic host](/samples/hosting/generic-host/index.md)

## Hosting technologies

### Web hosting

NServiceBus can be hosted using any web technology that supports .NET. See [Web Application Hosting](web-application.md) for more information.

### WebJob hosting

NServiceBus can be hosted in a WebJob. See [Self-Hosting in Azure WebJobs](/samples/azure/webjob-host/index.md)

### Serverless hosting

NServiceBus can be hosted in several serverless environments such as [Azure Functions](/nservicebus/hosting/azure-functions-service-bus/index.md) and [AWS Lambda](/nservicebus/hosting/aws-lambda-simple-queue-service/index.md).

## Hosting environment requirements

NServiceBus endpoints have certain requirements for the hosting environment:

* The endpoint process needs write access to write log files. See the [logging documentation](/nservicebus/logging/index.md) for more details about the default log file location and how to configure logging.
* The endpoint process needs write access to write the startup diagnostics file. See the [startup diagnostics documentation](/nservicebus/hosting/startup-diagnostics.md) for more details about the diagnostic file.
* Since NServiceBus makes assumptions on aspects like assembly names, ILMerging any of the NServiceBus* assemblies is not supported.