Feature: Run FinOps hubs on your own hardware

docs-mslearn/TOC.yml

@@ -128,6 +128,8 @@
           href: toolkit/hubs/finops-hubs-overview.md
         - name: Create or upgrade hubs
           href: toolkit/hubs/deploy.md
+        - name: Run hubs locally
+          href: toolkit/hubs/run-hubs-locally.md
         - name: Configure private networking
           href: toolkit/hubs/private-networking.md
         - name: Configure scopes
@@ -246,6 +248,8 @@
               href: toolkit/powershell/hubs/deploy-finopshub.md
             - name: Initialize-FinOpsHubDeployment
               href: toolkit/powershell/hubs/initialize-finopshubdeployment.md
+            - name: Initialize-FinOpsHubLocal
+              href: toolkit/powershell/hubs/initialize-finopshublocal.md
             - name: Register-FinOpsHubProviders
               href: toolkit/powershell/hubs/register-finopshubproviders.md
             - name: Remove-FinOpsHub

docs-mslearn/toolkit/changelog.md

@@ -3,7 +3,7 @@ title: FinOps toolkit changelog
 description: Review the latest features and enhancements in the FinOps toolkit, including updates to FinOps hubs, Power BI reports, and more.
 author: MSBrett
 ms.author: brettwil
-ms.date: 07/30/2026
+ms.date: 07/31/2026
 ms.topic: reference
 ms.service: finops
 ms.subservice: finops-toolkit
@@ -74,6 +74,9 @@ _Released June 2026_
 
 ### [FinOps hubs](hubs/finops-hubs-overview.md) v15
 
+- **Added**
+  - Added a [Run hubs locally](hubs/run-hubs-locally.md) guide to stand up a FinOps hub in a local Kusto emulator container and ingest cost data using the same KQL, transforms, and open data as a deployed hub.
+  - Added a build-generated `finops-hub-local-opendata.kql` release artifact that loads the open data reference tables from CSV, so the local hub guide stays in sync with published open data instead of hard-coding schemas.
 - **Changed**
   - Added a callout to the `config_RunBackfillJob` backfill option clarifying that it isn't supported on Microsoft Customer Agreement (MCA) billing accounts or billing profiles ([#2113](https://github.com/microsoft/finops-toolkit/issues/2113)).
 - **Fixed**
@@ -100,6 +103,8 @@ _Released June 2026_
 
 ### [PowerShell module](powershell/powershell-commands.md) v15
 
+- **Added**
+  - Added [Initialize-FinOpsHubLocal](powershell/hubs/initialize-finopshublocal.md) to set up a local FinOps hub in a running Kusto emulator with one command.
 - **Changed**
   - Updated PowerShell test compatibility with Pester 6 ([#2204](https://github.com/microsoft/finops-toolkit/pull/2204)).
 - **Fixed**

docs-mslearn/toolkit/powershell/hubs/initialize-finopshublocal.md

@@ -0,0 +1,80 @@
+---
+title: Initialize-FinOpsHubLocal command
+description: Set up a local FinOps hub in a running Kusto emulator using the Initialize-FinOpsHubLocal command in the FinOpsToolkit module.
+author: MSBrett
+ms.author: brettwil
+ms.date: 07/31/2026
+ms.topic: reference
+ms.service: finops
+ms.subservice: finops-toolkit
+ms.reviewer: brettwil
+#customer intent: As a FinOps user, I want to set up a local FinOps hub with one command so I can explore my cost data without deploying Azure resources.
+---
+
+# Initialize-FinOpsHubLocal command
+
+The **Initialize-FinOpsHubLocal** command sets up a local FinOps hub in a running [Kusto emulator](/azure/data-explorer/kusto-emulator-overview). It creates the `Ingestion` and `Hub` databases, then downloads and applies the released FinOps hub setup scripts and open data load script, so the local hub uses the same KQL, transforms, and open data as a deployed hub.
+
+The command doesn't install Docker or manage the emulator container, and it doesn't ingest cost data. Start the emulator first, then run this command against its endpoint. For the full walkthrough, see [Run FinOps hubs locally](../../hubs/run-hubs-locally.md).
+
+<br>
+
+## Syntax
+
+```powershell
+Initialize-FinOpsHubLocal `
+    [-ClusterUri <string>] `
+    [-ReleaseUri <string>] `
+    [-RawRetentionInDays <int>] `
+    [-OpenDataPath <string>] `
+    [-SkipOpenData] `
+    [-Destination <string>] `
+    [-WhatIf]
+```
+
+<br>
+
+## Parameters
+
+| Name                  | Description                                                                                                       |
+| --------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `‑ClusterUri`         | Optional. Base URI of the running Kusto emulator. Default = `http://localhost:8082`.                             |
+| `‑ReleaseUri`         | Optional. Base URI to download the setup scripts and open data load script from. Default = the latest FinOps toolkit GitHub release. Point this at a local file server or a specific release to run offline or pin a version. |
+| `‑RawRetentionInDays` | Optional. Number of days to keep raw data in the `Ingestion` database. Default = `90`.                          |
+| `‑OpenDataPath`       | Optional. Path, as seen by the emulator, to the folder that holds the open data CSV files. Default = `/data/export/open-data`. |
+| `‑SkipOpenData`       | Optional. Skips loading the open data reference tables. Default = `false`.                                       |
+| `‑Destination`        | Optional. Local folder used to download the setup scripts. Default = temp folder.                               |
+| `‑WhatIf`             | Optional. Shows what would happen if the command runs without actually running it.                              |
+
+<br>
+
+## Examples
+
+### Set up a local hub
+
+```powershell
+Initialize-FinOpsHubLocal
+```
+
+Sets up a local FinOps hub in the emulator at `http://localhost:8082` using the latest release.
+
+### Set up the schema only
+
+```powershell
+Initialize-FinOpsHubLocal `
+    -RawRetentionInDays 30 `
+    -SkipOpenData
+```
+
+Creates the databases and applies the schema with 30-day raw retention, and skips loading open data.
+
+<br>
+
+## Related content
+
+Related solutions:
+
+- [Run FinOps hubs locally](../../hubs/run-hubs-locally.md)
+- [FinOps hubs](../../hubs/finops-hubs-overview.md)
+
+<br>

docs-mslearn/toolkit/powershell/powershell-commands.md

@@ -3,7 +3,7 @@ title: FinOps toolkit PowerShell module
 description: Automate and scale your FinOps efforts using the FinOps toolkit PowerShell module, which includes commands to manage FinOps solutions.
 author: flanakin
 ms.author: micflan
-ms.date: 04/01/2026
+ms.date: 07/31/2026
 ms.topic: reference
 ms.service: finops
 ms.subservice: finops-toolkit
@@ -64,6 +64,7 @@ The FinOps toolkit PowerShell module includes commands to manage FinOps solution
 - [Deploy-FinOpsHub](hubs/Deploy-FinOpsHub.md) – Deploy your first hub or update to the latest version.
 - [Get-FinOpsHub](hubs/Get-FinOpsHub.md) – Get details about your FinOps hub instance.
 - [Initialize-FinOpsHubDeployment](hubs/Initialize-FinOpsHubDeployment.md) – Initializes the deployment for FinOps hubs.
+- [Initialize-FinOpsHubLocal](hubs/initialize-finopshublocal.md) – Set up a local FinOps hub in a running Kusto emulator.
 - [Register-FinOpsHubProviders](hubs/Register-FinOpsHubProviders.md) – Registers resource providers for FinOps hubs.
 - [Remove-FinOpsHub](hubs/Remove-FinOpsHub.md) – Deletes a FinOps hub instance.
 

src/powershell/Private/Invoke-FinOpsHubLocalCommand.ps1

@@ -0,0 +1,87 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+<#
+    .SYNOPSIS
+    Sends a single command or query to a local FinOps hub (Kusto emulator) HTTP endpoint.
+
+    .DESCRIPTION
+    Posts a management command or query to a running Kusto emulator over its REST API. Used by Initialize-FinOpsHubLocal to set up a local FinOps hub. This command does not manage the container; the emulator must already be running.
+
+    .PARAMETER ClusterUri
+    Required. Base URI of the running Kusto emulator (for example, http://localhost:8082).
+
+    .PARAMETER Database
+    Required. Name of the database to run the command against.
+
+    .PARAMETER Command
+    Required. The management command (starting with '.') or query to run.
+
+    .PARAMETER Endpoint
+    Optional. The REST endpoint to use: 'mgmt' for management commands (default) or 'query' for queries.
+
+    .PARAMETER TimeoutSec
+    Optional. Maximum number of seconds to wait for a response. Default = 0 (wait indefinitely).
+#>
+function Invoke-FinOpsHubLocalCommand
+{
+    [Diagnostics.CodeAnalysis.SuppressMessage("PSAvoidUsingEmptyCatchBlock", "", Justification="Not all failures have a JSON error body (for example, a connection failure); ignore parse errors and fall through to rethrow the original exception.")]
+    [CmdletBinding()]
+    param
+    (
+        [Parameter(Mandatory)]
+        [ValidateNotNullOrEmpty()]
+        [string]
+        $ClusterUri,
+
+        [Parameter(Mandatory)]
+        [ValidateNotNullOrEmpty()]
+        [string]
+        $Database,
+
+        [Parameter(Mandatory)]
+        [ValidateNotNullOrEmpty()]
+        [string]
+        $Command,
+
+        [Parameter()]
+        [ValidateSet('mgmt', 'query')]
+        [string]
+        $Endpoint = 'mgmt',
+
+        [Parameter()]
+        [ValidateRange(0, [int]::MaxValue)]
+        [int]
+        $TimeoutSec = 0
+    )
+
+    $uri = '{0}/v1/rest/{1}' -f $ClusterUri.TrimEnd('/'), $Endpoint
+    $body = @{ db = $Database; csl = $Command } | ConvertTo-Json -Compress
+
+    try
+    {
+        return Invoke-RestMethod -Uri $uri -Method 'Post' -ContentType 'application/json' -Body $body -TimeoutSec $TimeoutSec -ErrorAction 'Stop'
+    }
+    catch
+    {
+        # Kusto returns a structured JSON error body. Surface its message/code when present;
+        # otherwise rethrow the original exception (for example, a connection failure) as-is.
+        $content = $null
+        if ($null -ne $_.ErrorDetails -and -not [string]::IsNullOrWhiteSpace($_.ErrorDetails.Message))
+        {
+            try
+            {
+                $content = $_.ErrorDetails.Message | ConvertFrom-Json -Depth 10
+            }
+            catch {}
+        }
+
+        if ($null -ne $content -and $content.PSObject.Properties['error'])
+        {
+            $errorBody = $content.error
+            throw ($script:LocalizedData.Common_ErrorResponse -f $errorBody.message, $errorBody.code)
+        }
+
+        throw
+    }
+}