mpol opened a new issue, #46316: URL: https://github.com/apache/airflow/issues/46316
### What do you see as an issue? When following https://airflow.apache.org/docs/apache-airflow/stable/start.html on an Ubuntu 24.04 system the `pip install` step fails with `error: externally-managed-environment`. I would expect it to fail in the same way on a Debian Bookworm system and probably on other current distribution versions. ### Solving the problem The Debian/Ubuntu error message gives good hints how to solve the problem, but I think that a quickstart document should provide steps that work out of the box. So they should involve creating a venv, or at least, if you assume users to have some required level Python knowledge, the document should warn the user that this step may be needed. ### Anything else The full error text: ``` error: externally-managed-environment × This environment is externally managed ╰─> To install Python packages system-wide, try apt install python3-xyz, where xyz is the package you are trying to install. If you wish to install a non-Debian-packaged Python package, create a virtual environment using python3 -m venv path/to/venv. Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make sure you have python3-full installed. If you wish to install a non-Debian packaged Python application, it may be easiest to use pipx install xyz, which will manage a virtual environment for you. Make sure you have pipx installed. See /usr/share/doc/python3.12/README.venv for more information. note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages. hint: See PEP 668 for the detailed specification. ``` ### Are you willing to submit PR? - [ ] Yes I am willing to submit a PR! ### Code of Conduct - [x] I agree to follow this project's [Code of Conduct](https://github.com/apache/airflow/blob/main/CODE_OF_CONDUCT.md) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: commits-unsubscr...@airflow.apache.org.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
