Deploy your app on Community Cloud

After you've organized your files and added your dependencies as described on the previous pages, you're ready to deploy your app to Community Cloud!

Select your repository and entrypoint file

  1. From your workspace at share.streamlit.io, in the upper-right corner, click "Create app."

    Deploy a new app from your workspace

  2. When asked "Do you already have an app?" click "Yup, I have an app."

  3. Fill in your repository, branch, and file path. Alternatively, to paste a link directly to your_app.py on GitHub, click "Paste GitHub URL."

  4. Optional: In the "App URL" field, choose a subdomain for your new app.

    Every Community Cloud app is deployed to a subdomain on streamlit.app, but you can change your app's subdomain at any time. For more information, see App settings. In the following example, Community Cloud will deploy an app to https://red-balloon.streamlit.app/.

    Fill in your app's information to deploy your app

    Although Community Cloud attempts to suggest available repositories and files, these suggestions are not always complete. If the desired information is not listed for any field, enter it manually.

Optional: Configure secrets and Python version

push_pin

Note

Streamlit Community Cloud supports all released versions of Python that are still receiving security updates. Streamlit Community Cloud defaults to version 3.12. You can select a version of your choice from the "Python version" dropdown in the "Advanced settings" modal. If an app is running a version of Python that becomes unsupported, it will be forcibly upgraded to the oldest supported version of Python and may break.

  1. Click "Advanced settings."

  2. Select your desired version of Python.

  3. To define environment variables and secrets, in the "Secrets" field, paste the contents of your secrets.toml file.

    For more information, see Community Cloud secrets management.

  4. Click "Save."

Advanced settings for deploying your app

Watch your app launch

Your app is now being deployed, and you can watch while it launches. Most apps are deployed within a few minutes, but if your app has a lot of dependencies, it may take longer. After the initial deployment, changes to your code should be reflected immediately in your app. Changes to your dependencies will be processed immediately, but may take a few minutes to install.

Watch your app launch
push_pin

Note

The Streamlit Community Cloud logs on the right-hand side of your app are only viewable to users with write access to your repository. These logs help you debug any issues with the app. Learn more about Streamlit Community Cloud logs.

View your app

That's it—you're done! Your app now has a unique URL that you can share with others. Read more about how to Share your app with viewers.

Unique subdomains

If the "Custom subdomain (optional)" field is blank when you deploy your app, a URL is assigned following a structure based on your GitHub repo. The subdomain of the URL is a dash-separated list of the following:

  • Repository owner (GitHub user or organization)
  • Repository name
  • Entrypoint file path
  • Branch name, if other than main or master
  • A random hash
https://[GitHub username or organization]-[repo name]-[app path]-[branch name]-[short hash].streamlit.app

For example, the following app is deployed from the streamlit organization. The repo is demo-self-driving and the app name is streamlit_app.py in the root directory. The branch name is master and therefore not included.

https://streamlit-demo-self-driving-streamlit-app-8jya0g.streamlit.app

Custom subdomains

Setting a custom subdomain makes it much easier to share your app because you can choose something memorable. To learn how to change the subdomain of a deployed app, see View or change your app's URL.

Previous: Secrets managementNext: Manage your app
forum

Still have questions?

Our forums are full of helpful information and Streamlit experts.