Manage your app
You can manage your app directly from the deployed app in your developer view or you can log in to your app dashboard at share.streamlit.io to view, deploy, delete, reboot, or favorite an app.
- Manage apps from your developer view
- Manage apps from your app dashboard
- Manage apps in GitHub
- App resources and limits
- App favoriting
- Analytics Modal
Manage apps from your developer view
Once you have deployed an app you will have a developer view for that app.
Click on the bottom right where it says "Manage app" to view your Cloud logs and other settings.
Once you've clicked on "Manage app", you will be able to view your app's logs. This is your primary place to troubleshoot any issues with your app.
You can also click on the "︙" overflow menu at the bottom of the Cloud logs to view other options for your app including the ability to download logs, reboot the app, delete the app, navigate to settings (which includes managing viewer access and app secrets), go to your app dashboard, go to documentation, contact support, or sign out.
Manage apps from your app dashboard
When you first log into share.streamlit.io you will land on your app dashboard, which gives you a list of all your deployed apps. This list does include apps deployed by other developers in your workspace, since you're all managers of those apps. Such apps are indicated with an icon like this one:
Streamlit Community Cloud is organized into workspaces, which automatically group your apps according to the corresponding GitHub repository's owner. If you are part of multiple repositories, then you will have multiple workspaces.
If an app's GitHub repository is owned by you, the app will appear in your personal workspace, named "<YourGitHubHandle>".
If an app's GitHub repository is owned by an organization (such as your company), the app will appear in a separate workspace, named "<GitHubOrganizationHandle>".
You will also have access to any workspaces containing app(s) for which you only have view access. These apps will have a "view-only" tooltip when you click on their respective hamburger menus.
To switch between workspaces, click on the workspace listed in the top right corner, then select the desired workspace name.
Reboot an app
If your app needs a hard reboot, click on the "︙" overflow menu to the right of the app and click to Reboot. This will interrupt any user that may currently be using that app. It may also take a few minutes for your app to re-deploy, and in that time you — and anyone visiting the app — will see the 'Your app is in the oven' screen.
The app settings let you pick a custom subdomain for your app, manage viewers of your apps and secrets of your apps. Click on the links to lean more about these features.
Manage apps in GitHub
Update your app
Your GitHub repository is the source for the app, so that means that any time you push an update to your repo you'll see it reflected in the app in almost real time. Try it out!
Streamlit also smartly detects whether you touched your dependencies, in which case it will automatically do a full redeploy for you—which will take a little more time. But since most updates don't involve dependency changes, you should usually see your app update in real time.
Add or remove dependencies
You can add/remove dependencies at any point by updating
requirements.txt (Python deps) or
packages.txt (Debian deps) and doing a
git push to your remote repo. This will cause Streamlit to detect there was a change in its dependencies, which will automatically trigger its installation.
It is best practice to pin your Streamlit version in
requirements.txt. Otherwise, the version may be auto-upgraded at any point without your knowledge, which could lead to undesired results (e.g. when we deprecate a feature in Streamlit).
App resources and limits
All Community Cloud users have access to the same resources and are subject to the same limits (1 GB of RAM). If your app is running slowly or you're hitting the 'Argh' page, we first highly recommend going through and implementing the suggestions in the following blog posts to prevent your app from hitting the resource limits and to detect if your Streamlit app leaks memory:
If your app exceeds its resource limits, you will see one of the following messages when you visit your app. If your app uses an older version of Streamlit (
<1.1.0) without memory fixes, you will see the message on the left. If your app uses a newer version of Streamlit (
>=1.1.0), you will see the message on the right:
Similarly, you will receive one of the following two emails from email@example.com with the subject "Your Streamlit app has gone over its resource limits 🤯":
If your app exceeds its resource limits, users with view-only access will see one of the following messages when they visit your app. They will see the message on the left if your app uses an older version of Streamlit (
<1.1.0) without memory fixes, and the message on the right if your app uses a newer version of Streamlit (
>=1.1.0). Viewers have the option to notify you when the app exceeds its resource limits:
Private apps will not hibernate, but public Community Cloud apps without traffic for 7 consecutive days will automatically go to sleep. This is done to alleviate resources and allow the best communal use of the platform! Here are some need to know's about how this works:
- As the app developer, you will receive an email after 5 days of no traffic on your app.
- If you would like to keep your app awake, you have one of two choices:
- Visit the app (create traffic).
- Push a commit to the app (this can be empty!).
- If left alone the app will go to sleep at the 7 day mark (2 days after you receive the email). When someone visits the app after this, they will see the sleeping page:
- To wake the app up, press the "Yes, get this app back up!" button. This can be done by anyone who wants to view the app, not just the app developer!
- You can also wake apps through your Streamlit Community Cloud dashboard. You will know which apps are sleeping because a moon icon will appear next to the app settings. To wake an app from the dashboard, click the moon.
Streamlit Community Cloud supports a "favorite" feature that lets you quickly access your apps from the app dashboard. Favorited apps appear at the top of the app dashboard with a yellow star (⭐) beside them. You can favorite and unfavorite apps in any workspace to which you have access.
Favorites are specific to your account. Other members of your workspace cannot see which apps you have favorited.
Favorite an app from your app dashboard
There are two ways to favorite an app from the app dashboard:
- Hover over an app and click the star (☆) that appears.
- Click on the "︙" overflow menu to the app's right and click to Favorite.
To unfavorite an app, either hover over the app and click the star (⭐) again, or click on the "︙" overflow menu to the app's right and click to Unfavorite.
You can also favorite an app from right within the app! Currently, in-app favoriting is available for apps that use Streamlit v1.4.0 or later. Note that in-app favoriting is not available on apps in your workspaces for which you only have view access.
When viewing any app in your workspace, click the star (☆) in the top-right corner of the app, besides the "☰" hamburger menu.
To unfavorite an app, click the star (⭐) again.
Click here to learn more about upgrading the Streamlit version of your app on Streamlit Community Cloud.
Once you have access to a Streamlit workspace, you have access to 2 types of analytics:
- Workspace analytics: shows you how many viewers in total have visited all the apps in your workspace.
- App viewers: shows you who has recently viewed your workspace’s individual apps and when.
The Analytics Modal is visible to everyone with access to your workspace, including admins, developers, or anyone with viewer access to a workspace.
Streamlit Community Cloud enables you to view analytics data for all apps in your workspace in one central dashboard. At a glance, you get an overview of how active your workspace is and how popular your apps are.
To view your Workspace analytics:
- Select the "Analytics" option on the dashboard header
- View the "Workspace" tab in the Analytics modal
You're presented with a graph that you can hover over to see the number of users who have viewed at least one app in your workspace that month. This viewers count includes apps that anyone in your workspace created.
Solid lines indicate fully-complete months on the dashboard, while dotted lines indicate the current in-progress month.
Viewers data on your dashboard starts from April 2022 and onward. April 2022 data was our first month comprehensively tracking user analytics in Streamlit workspaces, and our tracking is even more refined starting in May 2022 and onward.
In addition to a general overview of the activity of your workspace and the popularity of your apps, Streamlit Community Cloud allows you to drill down to the level of individual apps and understand their viewership better.
As an app developer or a viewer with access to a given workspace, you can see who has viewed a given app and when. Specifically, you can see the total viewers count of your app (since April 2022 and onward), the most recent unique viewers (capped up to your last 20 viewers), and a relative timestamp of their last view.
There are three ways to access the app viewers data:
From the app dashboard, click the "︙" overflow menu to the app's right and select Analytics:
Doing so opens the "App viewers" tab of the "Analytics" modal.
The dropdown selects your app by default and displays:
- The total (all time) number of unique viewers for the app.
- A list of the most recent viewers' names and a relative timestamp of their last view, sorted by the time since the last view (newest first).
Click the "Analytics" option on the dashboard header and select the "App viewers" tab:
Doing so opens the "App viewers" tab of the "Analytics" modal.
The first app in your workspace is pre-selected in the dropdown by default. You can select the app you want to see the analytics for by clicking the corresponding app in the dropdown.
You can also access app viewer analytics from right within individual apps! This is a capability if you have GitHub push access for a given app. Just view any app in your workspace as a developer, click the "︙" overflow menu at the bottom of the Cloud logs and select "Analytics":
App viewers for public vs private apps
For public apps, we anonymize all viewers outside your workspace to protect their privacy and display anonymous viewers as random pseudonyms. You'll still be able to see the identities of fellow members in your workspace, though.
Meanwhile, for private apps that are only accessible to your own workspace's viewers, you will be able to see the specific users who recently viewed your apps.
Additionally, you may occasionally see anonymous users in private apps. Rest assured, these anonymous users do have authorized view access granted by you or your workspace members.
Common reasons why users show up anonymously are:
- The app was previously public
- Given viewer viewed app in April 2022, when the Streamlit team was honing user identification for this feature
- Given viewer disconnected their SSO and GitHub accounts previously
See Streamlit's general Privacy Notice.