This is an automated email from the ASF dual-hosted git repository.
choo121600 pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new 2ec474642fa docs: clarify Ubuntu/Debian venv requirement in quick
start (#63244)
2ec474642fa is described below
commit 2ec474642fa50a914079d0499e4a8303bc16aad5
Author: Shae Alhusayni <[email protected]>
AuthorDate: Tue Mar 10 20:14:31 2026 -0700
docs: clarify Ubuntu/Debian venv requirement in quick start (#63244)
* docs: clarify venv requirement for pip on Ubuntu/Debian quick start
* docs: avoid Ubuntu version-specific wording in quick start
---
airflow-core/docs/start.rst | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/airflow-core/docs/start.rst b/airflow-core/docs/start.rst
index a2ed26fd34b..e1263ccd57e 100644
--- a/airflow-core/docs/start.rst
+++ b/airflow-core/docs/start.rst
@@ -67,7 +67,11 @@ This quick start guide will help you bootstrap an Airflow
standalone instance on
For creating virtual environment with ``uv``, refer to the documentation
here:
`Creating and Maintaining Local virtual environment with uv
<https://github.com/apache/airflow/blob/main/contributing-docs/07_local_virtualenv.rst#creating-and-maintaining-local-virtualenv-with-uv-recommended>`_
-For installation using ``pip`` and ``venv``, carry out following steps:
+For installation using ``pip`` and ``venv``, carry out following steps.
+On Debian/Ubuntu systems, Python may enforce
+externally managed environments (PEP 668), so use a virtual environment
+before running ``pip install`` commands:
+
.. code-block:: bash
# For Windows after WSL2 install, restart computer, then in WSL Ubuntu
terminal
