Error running app. If you need help, try the Streamlit docs and forums.

Using Streamlit
,
1

Error running app on Streamlit Community Cloud - Health check fails without any Python traceback

Are you running your app locally or is it deployed?

Both.

The application runs successfully on my local machine but fails only after deployment.

If your app is deployed:

Hosting Platform: Streamlit Community Cloud

Public App Link:

GitHub Repository

The repository is currently private, so I’m unable to share a public GitHub link. However, I’m happy to share any relevant code snippets or project files if needed.

Full Error Message

The deployed app displays:

Error running app.
If you need help, try the Streamlit docs and forums.

The deployment logs complete successfully until the final message:

❗️ The service has encountered an error while checking the health

No Python traceback or exception is shown in the logs.

Streamlit and Python Versions

Local Environment

  • Python 3.12.4 (also tested with Python 3.11.7)

Streamlit Community Cloud

  • Streamlit 1.52.2
  • Python 3.14.6

Additional Information

  • The app works perfectly on my local machine.
  • The repository clones successfully during deployment.
  • All dependencies install successfully.
  • I recently fixed an issue where my .parquet file was accidentally excluded by .gitignore. The file is now committed and available in the repository.
  • The parquet files are approximately 11 MB and 9 MB.
  • The deployment still fails with the health check error even after fixing the missing file.

Has anyone encountered this issue where the app works locally but fails on Streamlit Community Cloud with only a health check failure and no Python traceback?

Any suggestions on how to obtain a more detailed startup error or identify the cause would be greatly appreciated.

Thank you!

2

Hey, thanks for sharing all those details and welcome to the Streamlit community! :tada: This is a common frustration—your app works locally but fails on Streamlit Community Cloud with a health check error and no traceback. This usually means the app process crashed or failed to start, often due to missing files, incompatible dependencies, or resource limits, but the error isn’t surfaced in the logs. Since you recently fixed a missing .parquet file, double-check that all required files are present in your repo and that file paths are relative, not absolute. Also, ensure your requirements.txt lists all external dependencies and doesn’t include built-in modules, as this can break the build. If your app uses a lot of memory (large data files), it may also hit the 1GB resource limit on Community Cloud, causing silent failures during startup.

To get more info, click “Manage app” on your app page to view logs—sometimes the error appears there even if not in the main UI. If not, try simplifying your app to a minimal version (e.g., just st.write(“hello”)) and add back features one by one to isolate the issue. For more troubleshooting, see the official docs on app dependencies, file organization, and resource limits. If you’re still stuck, please share your requirements.txt and a minimal reproducible example—community members love to help debug! Folks, feel free to jump in with your insights or similar experiences!

Sources:

3

Here is my requirements.txt

streamlit>=1.58.0

pandas

plotly

numpy

python-dateutil

psutil

matplotlib

openpyxl