> For the complete documentation index, see [llms.txt](https://docs.thereportinghub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thereportinghub.com/getting-started/deployment-step-by-step/configure-reporting-hub-app-settings.md).

# Configure Reporting Hub App Settings

**You must be a Reporting Hub Global Admin to complete these steps.** The default Global Admin is the user who ran the installation. To grant Global Admin to additional users, go to **App Settings** > **Manage Seats**

With Power BI configured, finish your deployment inside Reporting Hub. There are three steps:

* Sync your groups
* Configure your Global Tenant settings
* Set your home page

## 1.  Sync Your Groups

{% hint style="success" %}
Security groups are used to assign permissions to tenants and content within Reporting Hub.
{% endhint %}

After installation, Reporting Hub is integrated with Entra ID (or the scheme you set in the optional step above), but it does not automatically sync your users and security groups. Sync your groups to make them available in Reporting Hub.

1. From your user profile, select **App Settings** > **Manage Groups**.
2. Select **Sync Groups**. 

This pulls all your security groups into Reporting Hub so they can be granted permissions throughout the app. For more detail, see the **Manage Groups** page in the in-app documentation.

<figure><img src="https://2452209205-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd5bUZ5n4bSLHFrpgX6Nj%2Fuploads%2FC2uFlBXYGO1fOqo5VM6E%2Fimage.png?alt=media&amp;token=9df50df0-fc29-4c00-8f8d-b39bd61514ca" alt=""><figcaption></figcaption></figure>

## 2. Configure Your Global Tenant Settings

{% hint style="success" %}
**Good to know:** Your Power BI Workspaces map to your Reporting Hub tenants. You can have as many workspaces mapped to a tenant as you would like.
{% endhint %}

After installation, your Reporting Hub tenant has no user permissions and no access to your Power BI workspaces yet. Set these up from your Global Tenant settings.

1. In Reporting Hub, select your user profile, then **App Settings** > **Tenant Admin**.
2. Select **Refresh Workspaces and Capacities**.

<figure><img src="https://2452209205-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd5bUZ5n4bSLHFrpgX6Nj%2Fuploads%2FWU21boVsCHD71gkxdCw6%2Fimage.png?alt=media&amp;token=b33bd648-aa30-4d00-8cd0-08b795d4c0b2" alt=""><figcaption><p>Select Refresh Workspaces &#x26; Capacities</p></figcaption></figure>

3. In the **Action** column on the table, select the **ellipses.**
4. Select **Edit.**

<figure><img src="https://2452209205-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd5bUZ5n4bSLHFrpgX6Nj%2Fuploads%2FY1DdMNMMNEwQMZo9fAWz%2Fimage.png?alt=media&amp;token=82e573f3-d374-4a1d-839d-8b1693106fa7" alt="" width="563"><figcaption><p>Select Edit</p></figcaption></figure>

5. Fill out the Tenant Settings form and click **Save.**

<table><thead><tr><th width="206">Field</th><th width="117">Required?</th><th>Description</th></tr></thead><tbody><tr><td><strong>Tenant Administrator</strong></td><td>Yes</td><td>The user who manages this tenant. After installation, the user who ran setup is a <strong>Platform Admin</strong> with <strong>Global Permissions. Select</strong> their name from the dropdown to make them the Tenant Administrator. To add more admins, use the <strong>Manage Seats</strong> page in <strong>App Settings</strong>.</td></tr><tr><td><strong>Power BI Workspaces</strong></td><td>Yes</td><td>Select the workspace(s) you want to integrate from the dropdown. Each workspace must first be configured in Power BI.</td></tr><tr><td><strong>Parent Group</strong></td><td>Optional</td><td>The top-level security group that controls access to the tenant. Leave blank to allow your entire organization; set it to restrict access to specific security groups. Users and groups must belong to this Parent Group to access the tenant.</td></tr></tbody></table>

{% hint style="info" %}
**Don't see your workspace?** If your Power BI workspace isn’t showing up in the app, it may be due to configuration or permission issues. Head over to our Troubleshooting Guide in-app to find out how to resolve it.
{% endhint %}

<figure><img src="https://2452209205-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fd5bUZ5n4bSLHFrpgX6Nj%2Fuploads%2FNJqSWWKkud28rHlSnZnp%2Fimage.png?alt=media&amp;token=f169c79f-dfa6-4dcb-84da-4b81edb7f74f" alt=""><figcaption><p>Tenant Settings Form</p></figcaption></figure>

## Next: Learn to Use Reporting Hub

You're now ready to start building your app and go live. Continue to Learn to Use Reporting Hub to work through the community onboarding space, where loading content, branding, tenant planning, and setting your home page are all covered.

{% content-ref url="/pages/fmYjHXgF7pL3ZhniLF1B" %}
[Learn to Use Reporting Hub](/getting-started/deployment-step-by-step/learn-to-use-reporting-hub.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.thereportinghub.com/getting-started/deployment-step-by-step/configure-reporting-hub-app-settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.