# App Engine deploy failed: invalid app.yaml (runtime not supported / entrypoint / handlers)

**Code:** `App Engine` · **Category:** Google Cloud / Firebase · **Seen on:** Google Cloud, Python

`gcloud app deploy` rejects the configuration or the app fails its health check after deploy.

## Meaning

Use a supported runtime (`runtime: python312`/`nodejs20`), define `entrypoint` for runtimes that need one (gunicorn/Node start), listen on `$PORT`, fix handler/static file paths, and check the App Engine default service account and enabled APIs. Read build logs in Cloud Build.

## Common causes

- Unsupported/removed runtime
- Missing entrypoint
- App not listening on `$PORT`
- Wrong static handler path
- App Engine API/billing not enabled

## Quick fix

1. Set a current `runtime` and `entrypoint`
2. Listen on `0.0.0.0:$PORT`
3. Check logs with `gcloud app logs tail`

## Detailed fix by platform

### YAML

1. 

```bash
runtime: python312
entrypoint: gunicorn -b :$PORT main:app
```


## How to diagnose

1. **Runtime** — Supported?
2. **Entrypoint** — Defined?
3. **Port** — $PORT?

---
Source: [WhatIsMyError](https://whatismyerror.com/errors/gcp/app-engine-deploy-failed-runtime-app-yaml)
