# uvicorn.run()

> Guide to `uvicorn.run()`, the programmatic interface of the Uvicorn ASGI server: every parameter with its type and default, examples, HTTPS, deployment and upgrade notes. Up to date with uvicorn 0.54.0 (September 2026).

6 pages, last updated 2026-10-05.

## Guide

- [uvicorn.run()](https://uvicorn.run/): What `uvicorn.run()` is, requirements, the latest uvicorn version and a quick start.
- [Parameters Reference](https://uvicorn.run/parameters/): Every `uvicorn.run()` parameter with its type, options and default.
- [Real-World Examples](https://uvicorn.run/examples/): Production, auto-reload, Config and Server objects, factory, environment-based config and test server examples.
- [HTTPS, TLS and HTTP/2](https://uvicorn.run/https/): HTTPS, mutual TLS, `ssl_context_factory` and experimental HTTP/2 with `zttp`.
- [Deployment & Best Practices](https://uvicorn.run/deployment/): Workers, SIGHUP restarts, reverse proxies, UNIX sockets, Gunicorn, graceful shutdown and best practices.
- [Upgrading uvicorn](https://uvicorn.run/upgrading/): Recent uvicorn changes that affect `uvicorn.run()`, and deprecations to handle when upgrading.
- [Full guide as markdown](https://uvicorn.run/llms-full.txt): every page above in one file

## Optional

- [Official Docs](https://uvicorn.dev/)
- [GitHub](https://github.com/Kludex/uvicorn)
- [FastAPI](https://fastapi.tiangolo.com/)
- [Starlette](https://www.starlette.io/)
- [Uvicorn release notes](https://uvicorn.dev/release-notes/)
- [Uvicorn settings](https://uvicorn.dev/settings/)