---
title: How To Install Sitecore Stream in a Local Sitecore Instance
description: Learn how to install Sitecore Stream locally on XP to preview AI features, boost productivity, and assess migration to Sitecore XM Cloud.
publish date: 2025-07-29
author: Ramiro Batallas
image: https://media2.oshyn.com/-/media/Oshyn/Insights/Blog/2025-07-29-How-To-Install-Sitecore-Stream-in-a-Local-Sitecore-Instance/blog_hero_install-sitecore-stream.jpg?rev=4c0c2bcf2d1144f99ba2ef75218938c3
url: http://www.oshyn.com/blog/2025/07/install-sitecore-stream-locally
---
# How To Install Sitecore Stream in a Local Sitecore Instance

![Hands on keyboard](https://media2.oshyn.com/-/media/Oshyn/Insights/Blog/2025-07-29-How-To-Install-Sitecore-Stream-in-a-Local-Sitecore-Instance/blog_hero_install-sitecore-stream.jpg?rev=4c0c2bcf2d1144f99ba2ef75218938c3&hash=FACD1ECFC2FC5CFAD06F9DF481ACA0DF)

Sitecore Stream’s AI capabilities help marketing teams increase productivity and accelerate speed to market for digital experiences. The Microsoft Azure OpenAI-powered solution is available for cloud versions of Sitecore products, but for companies currently using Sitecore XP on-premises, Stream isn’t out of reach.

Installing Stream locally can allow developers to preview upcoming Sitecore features and SaaS‑style releases in a safe sandbox and assess how those features can be used by the marketing team and the cost of implementing them.

This post will explain how to install Stream on a local Sitecore XP instance.

## Prerequisites

Before installing Sitecore Stream, make sure your local environment is ready with this checklist:

- Sitecore CLI installed and configured
- .NET 6 SDK (required for Sitecore Stream services)
- Node.js and NPM (optional, if customizing front-end components)
- Docker Desktop (optional if using containerized XP)
- Solr running (standard XP requirements)
- RabbitMQ (required for Sitecore Stream event bus)

## Your 6-Step Installation Guide

### Step 1: Install and Configure RabbitMQ

Sitecore Stream uses RabbitMQ for real-time messaging.


### Option 1 – Docker RabbitMQ (Recommended):

```
docker run -d --hostname my-rabbit --name rabbitmq \
    -p 5672:5672 -p 15672:15672 \
    rabbitmq:3-management
```

Access the UI at: http://localhost:15672

Default credentials: guest/guest

Create a new virtual host (e.g., /sitecore) and a new user with full permissions.

### Step 2: Download Sitecore Stream Package

Download the official Sitecore Stream package (usually named like Sitecore.Stream.X.X.X.nupkg) from the Sitecore Downloads Portal.

Extract or install it via NuGet CLI if integrating via a custom solution.

### Step 3: Configure Sitecore to Use Stream

Add the Stream module to your Sitecore instance:

#### If using Docker:

- Add the Sitecore Stream .nupkg or Docker layer to your container setup.
- Modify docker-compose.override.yml to include the Sitecore Stream role or custom service.

#### If using Local IIS:

1. Copy the Sitecore Stream files into the appropriate website bin, App_Config, and sitecore modules folders.
2. Merge the App_Config\Include\Sitecore.Stream.* config files into your instance.
3. Verify that Sitecore.Stream.EventBus config includes RabbitMQ connection strings like:


```
<setting name="Stream.EventBus.RabbitMQ.HostName" value="localhost" />
<setting name="Stream.EventBus.RabbitMQ.VirtualHost" value="/sitecore" />
<setting name="Stream.EventBus.RabbitMQ.UserName" value="sitecoreuser" />
<setting name="Stream.EventBus.RabbitMQ.Password" value="password123" />
```

### Step 4: Install Stream CLI Plugin (Optional but Recommended)

dotnet tool install --global Sitecore.Stream.Cli

This CLI helps manage publishers and consumers and tests the stream pipelines.

### Step 5: Enable Relevant Stream Pipelines

Sitecore Stream is inactive by default, so you must enable relevant pipelines.

Edit or create configuration patches to activate:


```
<sitecore>
 <stream>
   <pipelines>
     <event>
       <processor type="Sitecore.Stream.Pipelines.CustomProcessor, Sitecore.Stream" />
     </event>
   </pipelines>
 </stream>
</sitecore>
```

### Step 6: Verify the Installation

- Go to RabbitMQ UI → check for messages in queues like sitecore.item.saved
- Open Log Viewer and check for Sitecore.Stream log entries


### Use the Stream CLI to test:

```
sitecore stream ping
```

## Test Your Setup

Create or edit content in Sitecore and observe how the Stream processors capture and send events through RabbitMQ.

For example:

- Edit an item in the Content Editor.
- Check the queue sitecore.item.saved in RabbitMQ.
- The log should reflect a successful event dispatch.

### Pro Tips

- Security: Avoid using guest in production. Use a dedicated RabbitMQ user.
- Performance: Don’t overload with too many Stream subscribers while testing.
- Debugging: Enable verbose logging for Sitecore.Stream to trace message processing.

## Example Diagram
Here’s a high-level architecture overview of Sitecore Stream in a local environment:


```
+------------------+         +----------------+
| Sitecore XP App  | ----->  | RabbitMQ Broker|
+------------------+         +----------------+
         |                            |
         |   Stream Pipelines         |
         V                            V
   Event Consumers (e.g., Azure, MongoDB, Logging, etc.)
```

## Wrapping Up

Installing Sitecore Stream locally can help you embed its AI-driven capabilities into your local Sitecore XP instance or evaluate how to get the most out of it before migrating to the cloud.

Oshyn is a certified Sitecore partner who can help you get the most value out of your solution and help you move to Sitecore XM Cloud when you’re ready.