Spaces:
Sleeping
Sleeping
| title: Manage your app | |
| slug: /deploy/streamlit-community-cloud/manage-your-app | |
| # Manage your app | |
| You can manage your deployed app from your workspace at <a href="https://share.streamlit.io" target="_blank">share.streamlit.io</a> or directly from `<your-custom-subdomain>.streamlit.app`. You can view, deploy, delete, reboot, or favorite an app. | |
| ## Manage your app from your workspace | |
| Streamlit Community Cloud is organized into workspaces, which automatically group your apps according to the corresponding GitHub repository's owner. Your workspace is indicated in the upper-right corner. You will have one workspace that matches your GitHub username and additional workspaces for any GitHub organization or user who has granted you access. | |
| Additionally, if you have view-only access to an app, you will be able to see that app's workspace. When you do not have developer access to an app, your management options for that app will be restricted as shown in the following sections. | |
| To deploy or manage any app, always switch to the workspace matching the repository's owner first. | |
|  | |
| At the top of your workspace, "**Analytics**" is a shortcut to [App analytics](/deploy/streamlit-community-cloud/manage-your-app/app-analytics) and "**Settings**" links to your [Workspace settings](/deploy/streamlit-community-cloud/manage-your-account/workspace-settings) (not to be confused with [App settings](/deploy/streamlit-community-cloud/manage-your-app/app-settings) for each of your apps). | |
| ### App overflow menus | |
| Each app has a menu accessible from the overflow icon (<i style={{ verticalAlign: "-.25em" }} className={{ class: "material-icons-sharp" }}>more_vert</i>) to the right. | |
| - **Copy URL** — See [Copy your app's URL](/deploy/streamlit-community-cloud/share-your-app#copy-your-apps-url) | |
| - **Edit** — See [Edit your app with GitHub Codespaces](/deploy/streamlit-community-cloud/manage-your-app/edit-your-app#edit-your-app-with-github-codespaces) | |
| - **Favorite** — See [Favorite your app](/deploy/streamlit-community-cloud/manage-your-app/favorite-your-app) | |
| - **Analytics** — See [App analytics](/deploy/streamlit-community-cloud/manage-your-app/app-analytics) | |
| - **Reboot** — See [Reboot your app](/deploy/streamlit-community-cloud/manage-your-app/reboot-your-app) | |
| - **Delete** — See [Delete your app](/deploy/streamlit-community-cloud/manage-your-app/delete-your-app) | |
| - **Settings** — See [App settings](/deploy/streamlit-community-cloud/manage-your-app/app-settings) | |
|  | |
| If you have view-only access to an app, options will be restricted in that app's menu. | |
|  | |
| ## Manage your app directly from your app | |
| You can manage your deployed app directly from the app itself! Just make sure you are signed in to Streamlit Community Cloud then visit your app. | |
| ### Streamlit Community Cloud logs | |
| 1. From your app at `<your-custom-subdomain>.streamlit.app`, click "**Manage app**" in the lower-right corner. | |
|  | |
| 2. 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. | |
|  | |
| 3. You can access more developer options by clicking the overflow icon (<i style={{ verticalAlign: "-.25em" }} className={{ class: "material-icons-sharp" }}>more_vert</i>) at the bottom of your Cloud logs. To conveniently download your logs, click "**Download log**". | |
|  | |
| <Flex> | |
| <div> | |
| Other options accessible from Cloud logs are: | |
| - **Analytics** — See [App analytics](/deploy/streamlit-community-cloud/manage-your-app/app-analytics). | |
| - **Reboot app** — See [Reboot your app](/deploy/streamlit-community-cloud/manage-your-app/reboot-your-app). | |
| - **Delete app** — See [Delete your app](/deploy/streamlit-community-cloud/manage-your-app/delete-your-app). | |
| - **Settings** — See [App settings](/deploy/streamlit-community-cloud/manage-your-app/app-settings). | |
| - **Your apps** — Takes you to your [app workspace](#manage-your-app-from-your-workspace). | |
| - **Documentation** — Takes you to our documentation. | |
| - **Support** — Takes you to <a href="https://discuss.streamlit.io/" target="_blank">our forums</a>! | |
| </div> | |
| <div style={{ maxWidth: '30%', margin: "auto" }}> | |
| <Image src="/images/streamlit-community-cloud/cloud-logs-menu-XL.png" clean /> | |
| </div> | |
| </Flex> | |
| ### App menus | |
| From your app at `<your-custom-subdomain>.streamlit.app`, you can always access your [app's menu](/develop/concepts/architecture/app-chrome) just like you can when developing locally. The option to deploy your app is removed, but you can still clear your cache from here. | |
|  | |
| ## Manage your app 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 dependenciess) or `packages.txt` (Linux dependencies) and committing the changes to your repository on GitHub. This will cause Streamlit Community Cloud to detect there was a change in your dependencies and automatically trigger (re)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 | |
| ### Resource limits | |
| All Streamlit Community Cloud users have access to the same resources and are subject to the same limits. These limits may change at any time without notice. If your app meets or exceeds its limits, it may slow down from throttling or become nonfunctional. The limits as of February 2024 are approximately as follows: | |
| - CPU: 0.078 cores minimum, 2 cores maximum | |
| - Memory: 690MB minimum, 2.7GBs maximum | |
| - Storage: No minimum, 50GB maximum | |
| Symptoms that your app is running out of resources include the following: | |
| - Your app is running slowly. | |
| - Your app displays "🤯 This app has gone over its resource limits." | |
| - Your app displays "😦 Oh no." | |
| ### Good for the world | |
| Streamlit offers increased resources for apps with good-for-the-world use cases. Generally, these apps are used by an educational institution or nonprofit organization, are part of an open-source project, or benefit the world in some way. If your app is **not** primarily used by a for-profit company you can [apply for increased resources](https://share.hsforms.com/1DzDGAjUmSPy_2nUzBj3rlQ3wudj). | |
| If you are an educator or student looking to deploy additional private apps, please [apply to our education program](https://share.hsforms.com/1M_e2WDcSRFuKzA2iteoAIg3wudj) instead. | |
| ### Optimizing your app | |
| If your app is running slow or showing the error pages mentioned above, 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: | |
| - <a href="https://blog.streamlit.io/common-app-problems-resource-limits/" target="_blank">Common app problems: Resource limits</a> | |
| - <a href="https://blog.streamlit.io/3-steps-to-fix-app-memory-leaks/" target="_blank">3 steps to fix app memory leaks</a> | |
| If your app exceeds its resource limits, developers and viewers alike will see "😦 Oh no." | |
| <div style={{ maxWidth: '70%', margin: 'auto' }}> | |
| <Image alt="App state: Oh no. Error running your app." src="/images/streamlit-community-cloud/app-state-oh-no.png" /> | |
| </div> | |
| If see "😦 Oh no." when viewing your app, first check your Cloud logs for any specific errors. If there are no errors in your Cloud logs you are likely dealing with a resource issue. | |
| #### Developer view | |
| If you are logged into a developer account for an app over its limits, you can access "**Manage app**" from the lower-right corner of the app to reboot it and clear its memory. "**Manage app**" will be red and have a warning icon (<i style={{ verticalAlign: "-.25em" }} className={{ class: "material-icons-sharp" }}>error</i>). | |
|  | |
| ### App hibernation | |
| All 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! If you would like to keep your app awake, simply visit the app to create traffic or commit your app's repository, even if it's an empty commit! | |
| If left alone your app will go to sleep at the 7 day mark. When someone visits the app after this, they will see the sleeping page: | |
| <div style={{ maxWidth: '80%', margin: 'auto' }}> | |
| <Image alt="App state: Zzzz. This app has gone to sleep due to inactivity." src="/images/streamlit-community-cloud/app-state-zzzz.png" /> | |
| </div> | |
| To wake the app up, click "**Yes, get this app back up!**" This can be done by *anyone* who has access to view the app, not just the app developer! | |
| You can see which of your apps are asleep from your workspace. Sleeping apps have a moon icon (<i style={{ verticalAlign: "-.25em" }} className={{ class: "material-icons-sharp" }}>bedtime</i>) to the right. | |
|  | |