This is an automated email from the ASF dual-hosted git repository.
kaxilnaik pushed a commit to branch v3-0-test
in repository https://gitbox.apache.org/repos/asf/airflow.git
commit d10509a42328b7ee0f09193c2b7a370e6c8955c8
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Fri Aug 15 10:18:36 2025 +0800
[v3-0-test] docs: Guide for resolving UI TemplateNotFound in Breeze setup
(#54521) (#54530)
Co-authored-by: Vishal
<[email protected]>
---
contributing-docs/03_contributors_quick_start.rst | 20 ++++++++++++++++++++
1 file changed, 20 insertions(+)
diff --git a/contributing-docs/03_contributors_quick_start.rst
b/contributing-docs/03_contributors_quick_start.rst
index 8021095e83e..6748d59770c 100644
--- a/contributing-docs/03_contributors_quick_start.rst
+++ b/contributing-docs/03_contributors_quick_start.rst
@@ -445,6 +445,26 @@ see in CI in your local environment.
Once the package is installed, execute the breeze command again to resume
image building.
+ If you encounter an error such as
+
+ .. code-block:: text
+
+ jinja2.exceptions.TemplateNotFound: '/index.html' not found in search
path: '/opt/airflow/airflow-core/src/airflow/ui/dist'
+
+ you may need to compile the UI assets before starting the Breeze
environment. To do so, run the following command **before** executing step 4:
+
+ .. code-block:: bash
+
+ breeze compile-ui-assets
+
+ After running this, verify that the compiled UI assets have been added to
``/airflow/.build/ui``.
+
+ Then, proceed with:
+
+ .. code-block:: bash
+
+ breeze --python 3.10 --backend postgres
+
5. When you enter the Breeze environment you should see a prompt similar to
``root@e4756f6ac886:/opt/airflow#``. This
means that you are inside the Breeze container and ready to run most of the
development tasks. You can leave
