Launch Soterre PBI Analyzer

How to download, launch, and start using Soterre PBI Analyzer on your machine.

System Requirements

Requirement	Details
Operating System	Windows 10 or later (x64)
Browser	Any modern browser (Chrome, Edge, Firefox)
Network	Internet connection required for Power BI Service features

Local file analysis works fully offline.

---

Download and Launch

1. Download the latest Soterre PBI Analyzer release (.zip archive) provided by our team.

2. Extract the archive. Inside you will find:

   • pbi-analyzer.exe — Windows executable

3. Run the executable for your platform. A terminal window will open showing the server startup log.

4. Open your browser and navigate to:

   http://localhost:4533

   The Soterre PBI Analyzer UI will load automatically.

Tip: Keep the terminal window open while using the application. Closing it will stop the server.

---

Two Ways to Analyze Reports

Once the UI is loaded, you have two options:

Option A — Import a Local File

Use this when you already have a Power BI file on your machine.

1. On the main screen, choose Import Local File.

2. Select a file from your computer. Supported formats:

   Format	Description
   .pbix	Power BI Desktop report
   .pbit	Power BI template file

   Maximum file size: 100 MB.

3. The analyzer will process the file and display a full report — data model structure, visual statistics, unused elements, duplicates, and more.

Option B — Connect to Power BI Service

Use this to pull reports directly from your organization's Power BI tenant.

After you have your service principal credentials ready (see Set Up Power BI Service Credentials), add a tenant in the app:

1. Go to Settings in the upper menu.

2. Click "+ Add Tenant".

3. Fill in the form:

   Field	Required	Where to Find It
   Name	Optional	Your choice (e.g., "My Organization")
   Tenant ID	Yes	Azure Portal → Entra ID → Overview → Directory (tenant) ID
   Client ID	Yes	Azure Portal → App registrations → your app → Application (client) ID
   Client Secret	Yes	Copied when creating the secret (shown only once)
   Metrics Workspace ID	Optional*	URL of the Fabric Capacity Metrics workspace (GUID after /groups/)
   Metrics Dataset ID	Optional*	URL of the Fabric Capacity Metrics dataset (GUID after /datasets/)

   *Optional — without these, the Capacity module won't provide any data.

4. Click Save. The tenant will appear in the list, and you can start browsing its workspaces.

Once connected, you can browse workspaces, select datasets and reports, and run the analysis remotely.

First time connecting? Follow the Set Up Power BI Service Credentials guide to create and configure the required Azure AD application and permissions.