Skip to content

Commit

Permalink
Update start.rst
Browse files Browse the repository at this point in the history
added extra step for ubuntu/debian users 
issue: apache#46316
  • Loading branch information
fantom845 authored Jan 31, 2025
1 parent d2c3d96 commit a2ad494
Showing 1 changed file with 15 additions and 3 deletions.
18 changes: 15 additions & 3 deletions docs/apache-airflow/start.rst
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,19 @@ constraint files to enable reproducible installation, so using ``pip`` and const
export AIRFLOW_HOME=~/airflow
2. Install Airflow using the constraints file, which is determined based on the URL we pass:
2. Create and activate a virtual environment (recommended):

Debian/Ubuntu systems require Python packages to be installed in virtual environments. Create one with:

.. code-block:: bash
python -m venv airflow-venv
source airflow-venv/bin/activate
.. note::
Using a virtual environment is recommended even on non-Debian systems to avoid package conflicts. Debian/Ubuntu systems enforce this requirement starting with Python 3.11.

3. Install Airflow using the constraints file, which is determined based on the URL we pass:

.. code-block:: bash
:substitutions:
Expand All @@ -69,15 +81,15 @@ constraint files to enable reproducible installation, so using ``pip`` and const
pip install "apache-airflow==${AIRFLOW_VERSION}" --constraint "${CONSTRAINT_URL}"
3. Run Airflow Standalone:
4. Run Airflow Standalone:

The ``airflow standalone`` command initializes the database, creates a user, and starts all components.

.. code-block:: bash
airflow standalone
4. Access the Airflow UI:
5. Access the Airflow UI:

Visit ``localhost:8080`` in your browser and log in with the admin account details shown in the terminal. Enable the ``example_bash_operator`` DAG in the home page.

Expand Down

0 comments on commit a2ad494

Please sign in to comment.