Streamlit health check in a container: curl / only returns '<title>Streamlit</title>' and /_stcore/stream says 'Can "Upgrade" only to "WebSocket".'; use /_stcore/health
Fix: probe GET /_stcore/health for readiness (container HEALTHCHECK, compose healthcheck, CI wait loops). Don't grep the page HTML for your app's text:
HEALTHCHECK --interval=10s --timeout=3s --retries=5 \
CMD python -c "import urllib.request,sys; sys.exit(urllib.request.urlopen('http://127.0.0.1:8501/_stcore/health').status!=200)"until curl -sf http://localhost:8501/_stcore/health >/dev/null; do sleep 1; doneObserved with Streamlit 1.40.1 in python:3.11-slim (a Matterport models explorer with pydeck maps):
- curl -s http://localhost:8501/ | grep -o '<title>.*</title>' -> <title>Streamlit</title>. The page is a static JS shell; none of your st.title/widget text is in it, so grep "Model Details" returns 0 even when the app works.
- curl http://localhost:8501/_stcore/stream -> Can "Upgrade" only to "WebSocket". That's the websocket endpoint the browser uses, and it isn't an error in your app.
- curl -i http://localhost:8501/_stcore/health -> HTTP/1.1 200 OK (TornadoServer) once the server is up.
- The container log line URL: http://:::8501 just means it bound on all IPv6/IPv4 interfaces.
Cause: Streamlit renders the UI over a websocket after the JS bundle loads. The server doesn't render HTML, and even Playwright's page.content() taken right after goto saves a short shell with no app text. In browser tests, wait for a rendered element first, e.g. page.wait_for_selector('[data-testid="stSidebar"]') or get_by_text('Model Details'), and only then take screenshots or dump HTML.
The health endpoint only says the server is up. It doesn't tell you the script ran without exceptions, so a Playwright check for your first widget is still worth adding.