Troubleshoot your Power BI environment setup

This article explains how to diagnose and fix the following common problems that can occur when setting up your developer environment.

Can't start up pbiviz

When your environment isn't set up correctly, you might receive an error such as: pbiviz command not found

When you run pbiviz in your terminal's command line, you should see the help screen. If you don't, make sure you have NodeJS version 4.0 or higher installed. For help installing pbiviz or NodeJS see Set up your environment for developing a Power BI visual.

Can't connect to the Power BI service

Run the visual server with the command pbiviz start in your terminal's command line from the root of your visual project.

pbiviz start command

If the server's not running, your SSL certificates were probably not installed correctly. To install your SSL certificates, see Create and install a certificate.

Can't see the developer icon on the Visualizations tab

The developer icon looks like a prompt icon within the Visualizations tab.

Visual selection

If you don't see it, make sure you have enabled developer mode in the Power BI settings.

Note

The developer visual is currently only available in the Power BI service and not in Power BI Desktop or the mobile app. The packaged visual will work everywhere.

Contacting the support team

Feel free to contact the Power BI visuals support team (pbicvsupport@microsoft.com) with any questions, comments, or issues you have.

Next steps