Deploying an app to Dash Enterprise makes it available at https://<your-dash-enterprise-server>/<your-app-name>
to users with viewer access.
In this chapter, you’ll learn how to deploy an app from your workstation to Dash Enterprise. If you’re using Workspaces instead of working locally, go to
Deploying Changes with Workspaces.
If you already have the Dash Enterprise CLI installed and your device is logged in, skip to Deploying Your App.
To set up the CLI:
Install the Dash Enterprise CLI (requires Git and Python 3.8 - 3.11) if it isn’t already:
py
pip install dash-enterprise-libraries --extra-index-url <a href="https://<your-dash-enterprise-server>/packages">https://<your-dash-enterprise-server>/packages</a>
Log your device into the CLI:
txt
de --host example.plotly.host login
replacing the example host name with your Dash Enterprise host name (without https
).
Your browser opens to a page prompting you to grant access privileges (if it does not open automatically, use the provided URL).
To deploy your app:
de deploy <path> --name <app-name>
where <path>
is the path to the app folder on your workstation and <app-name>
is the name of the new or existing app (both are optional). If you don’t provide a path, Dash Enterprise uses the current directory. If you don’t provide an app name, Dash Enterprise uses the name of your app folder. Remember that the name is used in the app URL and cannot be changed later.
If the app isn’t initialized (and the name is available), you are prompted to confirm that you want to initialize it. It is then initialized and deployed. If the app is initialized, you are prompted to confirm that you want to overwrite it, and it is deployed.
If you receive an error, refer to Common Errors for help troubleshooting.
When the deployment is successful, an Upcoming Build card is displayed at the top of the App Info Overview. The Cancel Build action becomes available.
<img>
Seeing “Build Queued”? Dash Enterprise can build a maximum of 5 total combined apps and workspaces at a time.
If other app developers push changes and create workspaces in a short amount of time such that this limit is reached, Dash Enterprise
places your build in a queue and completes it after the in-progress builds.
When the build is complete, several things happen:
Dash Enterprise serves your app’s latest version. View the app by using its URL or selecting it from the Portal.
The Overview is updated with the Latest Build information. The Rebuild & Deploy action becomes available.
<img>
The Live status indicates that the running app is based off this build. Expand Show Build Logs to view build logs.
Known issue: We are aware of an issue where build logs are sometimes incomplete, slow, or out of order. If you are an administrator with access to the Kubernetes cluster that Dash Enterprise is installed on,
consider using Lens to view build logs directly from the Kubernetes pod.
Procfile
. Stop and Start actions become available for each process.<img>
The Builds tab is populated. If this is the app’s first build, it displays the same information as Latest Build in the Overview. Once your
app has undergone changes, you’ll be able to view historical build logs from this tab.
The Logs tab displays your app’s runtime logs. Learn more about app logs.
The GIT_REV