# Enterprise Troubleshooting

### The Browser Extension is not installing via GPO <a href="#block-ab3977a900b948fc99cdd69b53ef9fd7" id="block-ab3977a900b948fc99cdd69b53ef9fd7"></a>

If you have configured a GPO/ADMX policy but the browser is not installing extension, verify the following:

Verify the policy is being applied:

* Chrome: `chrome://policy/`
* Edge: `edge://policy/`

Verify your Network Firewall is configured to allow access to the extension update site. See [network-email-firewall-configuration](https://docs.pixiebrix.com/enterprise-it-setup/network-email-firewall-configuration "mention")&#x20;

### Follow the Team Member Troubleshooting Guide <a href="#block-ab3977a900b948fc99cdd69b53ef9fd7" id="block-ab3977a900b948fc99cdd69b53ef9fd7"></a>

Depending on the problem, the solution may be available in the [Mod User Troubleshooting guide](https://docs.pixiebrix.com/activating-mods/troubleshooting).

### Verify PixieBrix has Permission to Access the Page <a href="#block-bbe588224dfc4048a274ebacebdab01f" id="block-bbe588224dfc4048a274ebacebdab01f"></a>

If a button/menu item is not appearing:

* Right click the PixieBrix icon in the browser toolbar and verify it says "On \<origin>"

  <figure><img src="https://images.spr.so/cdn-cgi/imagedelivery/j42No7y-dcokJuNgXeA0ig/75207a67-d0bf-4d47-8331-eb06adb14983/Untitled/w=1080,quality=80" alt=""><figcaption></figcaption></figure>
* Click the PixieBrix toolbar icon to toggle the sidebar, does the extension now run? If it runs, this indicates the extension is configured properly, but that the permissions are not active
* Check the Settings page. Does the URL match any of patterns under "Additional Permissions"?

### Check User Error Telemetry <a href="#block-26d05464d0594a678573f99473c23990" id="block-26d05464d0594a678573f99473c23990"></a>

From the [Team Admin](https://app.pixiebrix.com/team) page, select the user experience problems and view the "Error Telemetry" tab.

{% hint style="danger" %}
The error telemetry is currently verbose, e.g., reporting cancellations as errors. Some of the events you see might not be causing the problem the team member is experience
{% endhint %}

<figure><img src="https://images.spr.so/cdn-cgi/imagedelivery/j42No7y-dcokJuNgXeA0ig/e398b3ce-57b6-44d4-a2bf-df7b7778af2e/Untitled/w=828,quality=80" alt="" width="375"><figcaption></figcaption></figure>

### Check the User Extension and Deployment Package Version <a href="#block-2eaa8dea2fa340bfbef6ac8d8f15dc4d" id="block-2eaa8dea2fa340bfbef6ac8d8f15dc4d"></a>

From the deployment detail page, view the "Status" tab to verify what version of the deployment and PixieBrix browser extension each user has active

<figure><img src="https://images.spr.so/cdn-cgi/imagedelivery/j42No7y-dcokJuNgXeA0ig/ea5891a1-e0d4-420b-9807-7a98939f92af/Untitled/w=1200,quality=80" alt=""><figcaption></figcaption></figure>

### Replicating the Problem Locally <a href="#block-b16d619a8c5e4cb894636d231be6895d" id="block-b16d619a8c5e4cb894636d231be6895d"></a>

As a developer, try replicating the problem on your machine

#### Brick Error Log <a href="#block-9689ea1de2654d85b98f0a319cd02365" id="block-9689ea1de2654d85b98f0a319cd02365"></a>

To view the error logs for the brick, open the mod and select the Brick from the "Active Bricks" screen.

To view the verbose logs (from all levels), select "DEBUG" from the log level dropdown

<figure><img src="https://images.spr.so/cdn-cgi/imagedelivery/j42No7y-dcokJuNgXeA0ig/f0aeeb2a-5d94-4c5b-9d75-948c2b9ec70c/Untitled/w=1200,quality=80" alt=""><figcaption></figcaption></figure>

You can refresh the available log messages without reloading the page by clicking "Refresh"

#### Browser Developer Console <a href="#block-81bb460329694ccf8387889641426767" id="block-81bb460329694ccf8387889641426767"></a>

If the error does not appear in the Brick Error Log, [open your browser's console log](https://developer.chrome.com/docs/devtools/console/#view)

{% hint style="danger" %}
The console will also shows messages/errors from the host page and any other extensions you have installed
{% endhint %}

To only show messages from the PixieBrix extension, check "Selected context only" from the Console settings\ <br>

<figure><img src="https://images.spr.so/cdn-cgi/imagedelivery/j42No7y-dcokJuNgXeA0ig/4f9c56d8-72bc-4a73-836d-93ea4e54df48/Untitled/w=640,quality=80" alt="" width="375"><figcaption></figcaption></figure>

Then, select top → PixieBrix from the context dropdown\ <br>

<figure><img src="https://images.spr.so/cdn-cgi/imagedelivery/j42No7y-dcokJuNgXeA0ig/1533e1ca-3bb7-4708-b36f-fdf95e3b3563/Untitled/w=640,quality=80" alt="" width="375"><figcaption></figcaption></figure>

Additionally, ensure "Verbose" log messages are turned on to get additional context about any error messages\ <br>

<figure><img src="https://images.spr.so/cdn-cgi/imagedelivery/j42No7y-dcokJuNgXeA0ig/9e66ba61-beb1-4c68-90d1-5114630fad21/Untitled/w=640,quality=80" alt="" width="375"><figcaption></figcaption></figure>

### Check the Service PixieBrix Status Page <a href="#block-6e354b2460b64e83a9db0e415c8212dd" id="block-6e354b2460b64e83a9db0e415c8212dd"></a>

{% hint style="info" %}
Unless your deployments are using PixieBrix's API proxy or using a team database, user operations are not transmitted through PixieBrix's services, and should not cause degradation of deployed mods.
{% endhint %}

Check our [Status Page](https://pixiebrix.statuspage.io/) to see if any of our services are experiencing degraded service

### User unable to login <a href="#block-6d196b0a04ea40cbb4ce938eefaf8faf" id="block-6d196b0a04ea40cbb4ce938eefaf8faf"></a>

> Your email address is not enabled. Contact the administrator for \<TEAM\_NAME>"

A new user must be added to at least one of the team’s campaigns before they can log in. If you’re seeing this error, then add the user to a campaign and have them retry logging in.

### Browser Extension is Crashing <a href="#block-ef9e58d2c58d414684563009f1b0f8e4" id="block-ef9e58d2c58d414684563009f1b0f8e4"></a>

The most common cause for the Chrome Browser Extension crashing is that debug logs have started taking up too much space.

#### Fix 1: Disable Debug Logging <a href="#block-74f5f586262543369c36d3a421cf8d4b" id="block-74f5f586262543369c36d3a421cf8d4b"></a>

* Check the Settings > Developer Settings section in the Extension Console
  * Clear the local logs
  * Ensure Log Values is Disabled

#### Fix 2: Factory Reset the Browser Extension <a href="#block-f73fd88376f4488ea298d11a96a27a2d" id="block-f73fd88376f4488ea298d11a96a27a2d"></a>

If your browser extension install has been corrupted, you can reset the browser extension install state.

* Visit Settings > Factory Reset and click the “Factory Reset” button

{% hint style="danger" %}
The Factory Reset Button is not available to restricted enterprise team members.
{% endhint %}

### Contact Support <a href="#block-bdb737c9af434003ba44ad982848796c" id="block-bdb737c9af434003ba44ad982848796c"></a>

Email PixieBrix support at <support@pixiebrix.com>.<br>
