This is an automated email from the ASF dual-hosted git repository.
potiuk 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 e33a4f6dc78 Clarify How to upgrade docs for PyPI installs (#70897)
e33a4f6dc78 is described below
commit e33a4f6dc78c841455fec9741c6ebed0d26fb98e
Author: Digvijay <[email protected]>
AuthorDate: Thu Aug 13 12:38:33 2026 -0500
Clarify How to upgrade docs for PyPI installs (#70897)
Remove the undefined "bootstrapped local instance" guidance and point
readers at the Installation and upgrade scenarios section instead.
Signed-off-by: Digvijay Waghela <[email protected]>
---
airflow-core/docs/installation/installing-from-pypi.rst | 2 ++
airflow-core/docs/installation/upgrading.rst | 8 ++------
2 files changed, 4 insertions(+), 6 deletions(-)
diff --git a/airflow-core/docs/installation/installing-from-pypi.rst
b/airflow-core/docs/installation/installing-from-pypi.rst
index bfcd1d4e9c4..87727f19710 100644
--- a/airflow-core/docs/installation/installing-from-pypi.rst
+++ b/airflow-core/docs/installation/installing-from-pypi.rst
@@ -260,6 +260,8 @@ Airflow version. Whenever we release a new version of
Airflow, we upgrade all de
applicable versions and test them together, so if you want to keep up with
those tests - staying up-to-date
with latest version of Airflow is the easiest way to update those dependencies.
+.. _installing-from-pypi-installation-and-upgrade-scenarios:
+
Installation and upgrade scenarios
''''''''''''''''''''''''''''''''''
diff --git a/airflow-core/docs/installation/upgrading.rst
b/airflow-core/docs/installation/upgrading.rst
index 990d97ed1fe..50822bae775 100644
--- a/airflow-core/docs/installation/upgrading.rst
+++ b/airflow-core/docs/installation/upgrading.rst
@@ -59,13 +59,9 @@ How to upgrade
Reinstall Apache Airflow®, specifying the desired new version.
-To upgrade a bootstrapped local instance, you can set the ``AIRFLOW_VERSION``
environment variable to the
-intended version prior to rerunning the installation command. Upgrade
incrementally by patch version: e.g.,
-if upgrading from version 2.8.2 to 2.8.4, upgrade first to 2.8.3. For more
detailed guidance, see
-:doc:`/start`.
-
To upgrade a PyPI package, rerun the ``pip install`` command in your
environment using the desired version
-as a constraint. For more detailed guidance, see
:doc:`/installation/installing-from-pypi`.
+as a constraint. For detailed installation and upgrade scenarios, see
+:ref:`installing-from-pypi-installation-and-upgrade-scenarios`.
In order to manually migrate the database you should run the ``airflow db
migrate`` command in your
environment. It can be run either in your virtual environment or in the
containers that give
