Troubleshooting Using Workspaces

This documentation is for Dash Enterprise.
Dash Enterprise is the fastest way to write & deploy Dash apps and
Jupyter notebooks.
10% of the Fortune 500 uses Dash Enterprise to productionize AI and
data science apps. Find out if your company is using Dash Enterprise.

This page applies to Dash Enterprise 5. If your organization uses Dash Enterprise 4, view the Workspaces docs at https://<your-dash-enterprise-server>/Docs/workspaces.

When deploying your app to Dash Enterprise, if it fails to build, the UI will show a build failure message. You can use an app’s workspace as a tool for debugging build failures, as from within the workspace, you have access to the terminal on the same platform and build environment.

Try Reinstalling Packages

Open the workspace, and install packages using commands that the build process uses. For example, in the workspace terminal if you have pip packages:
pip install -r requirements.txt

Once you’ve found which Python packages and versions work, you can save the currently installed packages to your requirements.txt file. See the Python Package Management page for more details.

If your deployed application relies on an Aptfile, trying installing each of the apt packages in it individually with:
sudo apt-get install <package_name>

Similarly for conda packages: conda install <conda>


If you discovered your issue and fixed it within the workspace, then commit and deploy your changes. This will trigger a rebuild. If it still fails to build, go to the Builds tab for the app and select Show Build Logs to continue troubleshooting.