Publishing from Local Files

Already have a Dash app written and ready to publish? This guide can help you take the app files on your workstation and turn them into a published app on Plotly Cloud.

There are three ways to publish from app files on your workstation: You can upload the files in the Cloud UI at cloud.plotly.com, publish directly from a Dash app running in debug mode, or use the Plotly Cloud CLI from the terminal. This guide covers all three methods. Note that the file size limit is 80 MiB when uploading at cloud.plotly.com and 200 MiB when publishing from dev tools or the CLI.

Preparing Your App Files

Plotly Cloud expects your app files to meet certain requirements. In this step, you’ll review your files and make any adjustments needed to meet the requirements.

To prepare your app files:

• Make sure that the total size of your files is less than 80 MiB if publishing at cloud.plotly.com, or less than 200 MiB if publishing from Dash dev tools.

• (Optional) List your app dependencies in a pyproject.toml or requirements.txt file. Including one of these files lets Plotly Cloud know which dependencies to install for your app, but is not required in most cases. If you do not upload a pyproject.toml or requirements.txt file, Plotly Cloud will examine your app code and install the latest versions of the packages that it depends on. We recommend specifying dependencies in pyproject.toml or requirements.txt file if at least one of the following is true:

  • Your app leverages features of these files (such as using --extra-index-url with requirements.txt to fetch a package from a private source).
  • At least one of your app dependencies needs to be pinned to a specific version that is not the latest.
  • You want to ensure that the same dependency versions are used whenever you publish a new revision of your app (including new revisions that are automatically created when you apply a settings change).

  Tip: You can generate a requirements.txt based on the Python packages present in a local environment where your app successfully runs (ideally a virtual environment dedicated to your app). To do this, activate the environment and then run pip freeze > requirements.txt. You can also check the environment’s Python version with python --version (you’ll be asked to select a Python version in a later step).

Publishing from the Cloud UI

Uploading Your App Files to Plotly Cloud

To upload your app files:

1. Go to Plotly Cloud: https://cloud.plotly.com/

2. Select Publish.

3. In a different window, browse to your app files. Multi-select the files and/or folders and then drag them to the upload area. Alternatively, if your app files are all in a single folder, you can select the upload area and then select your folder.

   Plotly Cloud verifies that your files meet the requirements described above.

   If you included a pyproject.toml or requirements.txt file, Plotly Cloud installs the specified dependencies. If not, Plotly Cloud examines your app code and installs the latest versions of the packages that the code depends on.

   If you accidentally upload unneeded folders like .git or .venv, they are omitted to reduce the final app size.

   If you forget some files or if you need to make further changes to meet the requirements, select Remove and then drag the new set of files.

   <img>

Configuring General Settings

Several options are available under Configuration:

• Name: Identifies your app when you manage it on Plotly Cloud. You can change the automatically generated name to one that you prefer.

• App URL: The unique URL where users will go to view the live app. You can change the default URL if you have a Plotly Pro plan (or higher).

• Main file: Select the Python file that contains the Dash app definition.

• Python version: The Python version that Plotly Cloud will use to build your app. App dependencies that you optionally specify in a pyproject.toml or requirements.txt file must be compatible with this Python version.

• Environment variables (optional): Values that your app code expects in the live app environment. For more information, see Environment Variables.

  <img>

When everything looks good, select Save & publish.

You’re taken to your apps list where you can monitor the status of your new app. If Plotly Cloud is able to successfully build and run your app, its status progresses to Running (you can follow along in the logs).

Select View in new tab <img> to view the live app.

Publishing from Dash Dev Tools

To publish your app from dev tools:

1. Install the Plotly Cloud extension:
   bash pip install "dash[cloud]"

2. Run your app in debug mode by setting debug=True on app.run in your app code:
   python app.run(debug=True)

3. Select Plotly Cloud in the dev tools UI and select Sign In.

4. Authenticate to Plotly Cloud in the browser tab that opens.

5. Return to your running Dash app in the browser, give the app a name, select the team you want to publish to, and select Publish App. Once your app builds and starts, you’ll see an App is live message. Select View App to see it on Plotly Cloud.

Note: When publishing, the Plotly Cloud extension ignores virtual environments and Python cache files. Configure additional files or folders to ignore using a .gitignore file in your app folder.

Publishing Using the Plotly Cloud CLI

You can also publish apps from the terminal using the Plotly Cloud CLI.

To publish an app using the CLI:

1. Install the Plotly Cloud extension:
   bash pip install "dash[cloud]"

2. Log in to Plotly Cloud:
   bash plotly user login

3. Navigate to your app directory and publish:
   bash plotly app publish
   The first time you publish an app, the CLI prompts you for an app name. You can also provide the name with the --name option:
   bash plotly app publish --name my-app

Note: When publishing, the Plotly Cloud extension ignores virtual environments and Python cache files. Configure additional files or folders to ignore using a .gitignore file in your app folder.

For the full list of available CLI commands and options, see the CLI Reference.

Next, you may want to share or update your app.