How to Install Apache Airflow on Ubuntu 24.04

by cobra_admin
April 10, 2025
209

Prerequisites

Before you begin, you need to:

Have access to an Ubuntu 24.04 instance with at least 4 GB RAM.
Create a new domain A record pointing to the instance’s IP address.

Install Apache Airflow on Ubuntu 2.04

Apache Airflow is available as a Python package you can install using a package manager such as Pip. Follow the steps below to install Python if it’s not available on your system, create a new virtual environment, and install Apache Airflow.

Update the server’s package index.
CONSOLE
```
$ sudo apt update
```
View the available Python version on your server.
CONSOLE
```
$ python3 --version
```
Your output should be similar to the one below.
```
Python 3.12.3
```
Install Python if it’s not available on your server.
CONSOLE
```
$ sudo apt install python3
```
Install the python3-venv Python virtual environment module and the PostgreSQL development library.
CONSOLE
```
$ sudo apt install python3-venv libpq-dev -y
```
Create a new virtual environment such as airflow_env.
CONSOLE
```
$ python3 -m venv airflow_env
```
Activate the airflow_env virtual environment.
CONSOLE
```
$ source ~/airflow_env/bin/activate
```
Verify that your shell prompt changes to the airflow_env virtual environment.
CONSOLE
```
(airflow_env) linuxuser@example:~$
```
Use Pip to install Apache Airflow with support for PostgresQL.
CONSOLE
```
$ pip install apache-airflow[postgres] psycopg2
```

Install PostgreSQL.

CONSOLE

$ sudo apt install postgresql postgresql-contrib

Start the PostgreSQL service.
CONSOLE
```
$ sudo systemctl start postgresql
```
Access the PostgreSQL console using the postgres user.
CONSOLE
```
$ sudo -u postgres psql
```
Your output should be similar to the one below:
```
psql (16.6 (Ubuntu 16.6-0ubuntu0.24.04.1))
Type "help" for help.

postgres=# 
```
Create a new airflow PostgreSQL user with a strong password. Replace YourStrongPassword with your desired password.
PSQL
```
postgres=# CREATE USER airflow PASSWORD 'YourStrongPassword';
```
Create a new database, for example, airflowdb.
PSQL
```
postgres=# CREATE DATABASE airflowdb;
```

Grant the airflow user full privileges to all tables in the public schema.

PSQL

postgres=# GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO airflow;

Grant the airflow user ownership privileges to the airflowdb database.
PSQL
```
postgres=# ALTER DATABASE airflowdb OWNER TO airflow;
```
Grant the airflow user all privileges on the public schema.
PSQL
```
postgres=# GRANT ALL ON SCHEMA public TO airflow;
```
Exit the PostgreSQL console.
PSQL
```
postgres=# exit;
```
Open the airflow.cfg file in your Airflow installation directory.
CONSOLE
```
$ nano ~/airflow/airflow.cfg
```
Temporarily initialize the database and start the Airflow scheduler to create the necessary directories if the airflow directory is missing.
CONSOLE
```
$ airflow db init; airflow scheduler
```
Press CTRL+C to stop the scheduler.
Replace the default executor and sql_alchemy_conn values with the following configuration to enable parallel execution and set PostgreSQL as the metadata database.
INI
```
executor = LocalExecutor
sql_alchemy_conn = postgresql+psycopg2://airflow:YourStrongPassword@localhost/airflowdb
```
Save and close the file.

Initialize the Airflow metadata database to apply the changes.

CONSOLE

$ airflow db init

Your output should be similar to the one below:

DB: postgresql+psycopg2://airflow:***@localhost/airflow
[2025-01-05T23:58:36.808+0000] {migration.py:207} INFO - Context impl PostgresqlImpl.
[2025-01-05T23:58:36.809+0000] {migration.py:210} INFO - Will assume transactional DDL.
INFO  [alembic.runtime.migration] Context impl PostgresqlImpl.
INFO  [alembic.runtime.migration] Will assume transactional DDL.
INFO  [alembic.runtime.migration] Running stamp_revision  -> 5f2621c13b39
WARNI [airflow.models.crypto] empty cryptography key - values will not be stored encrypted.
Initialization done

Create a new administrative user to use with Apache Airflow. Replace admin with your desired username.

CONSOLE

$ airflow users create \
   --username admin \
   --password yourSuperSecretPassword \
   --firstname Admin \
   --lastname User \
   --role Admin \
   --email admin@example.com

Start the Airflow web server on port 8080 as a background process and redirect all logs to the webserver.log file.
CONSOLE
```
$ nohup airflow webserver -p 8080 > webserver.log 2>&1 &
```
Start the Airflow scheduler and redirect all logs to the scheduler.log file.
CONSOLE
```
$ nohup airflow scheduler > scheduler.log 2>&1 &
```

Configure Nginx as a Reverse Proxy to Expose Apache Airflow

Apache Airflow listens for connections using the default port 8080. Follow the steps below to secure Apache Airflow’s port using Nginx and serve requests over HTTP and HTTPS.

Install Nginx.
CONSOLE
```
$ sudo apt install -y nginx
```
Create a new airflow Nginx virtual host configuration file.
CONSOLE
```
$ sudo nano /etc/nginx/sites-available/airflow
```

Add the following configurations to the file. Replace airflow.example.com with your actual domain.

NGINX

server {
    listen 80;
    server_name airflow.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Save and close the file.

The above Nginx configuration listens for incoming connections using your airflow.example.com domain and forwards all connections to the Apache Airflow port 8080.

Link the Airflow configuration to the Nginx sites-enabled directory to enable it.
CONSOLE
```
$ sudo ln -s /etc/nginx/sites-available/airflow /etc/nginx/sites-enabled/
```

Test the Nginx configuration for errors.

CONSOLE

$ sudo nginx -t

Your output should be similar to the one below.

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Reload Nginx to apply the configuration changes.
CONSOLE
```
$ sudo systemctl reload nginx
```
Allow connections to the HTTP port 80 through the firewall.
CONSOLE
```
$ sudo ufw allow 80/tcp
```
Reload UFW to apply the firewall configuration changes.
CONSOLE
```
$ sudo ufw reload
```
Access your airflow.example.com domain using a web browser such as Chrome and verify that the Airflow login page displays.
```
http://airflow.example.com
```

Generate Trusted SSL Certificates to Secure Apache Airflow

SSL certificates encrypt the connection between a client and the Apache Airflow server. Follow the steps below to generate Let’s Encrypt SSL certificates using Certbot to secure connections to Apache Airflow.

Install the Certbot Let’s Encrypt Client.
CONSOLE
```
$ sudo snap install --classic certbot
```
Install Snap if it’s not available on your workstation.
CONSOLE
```
$ sudo apt install snapd -y
```
Move the Certbot binary to the /usr/bin path to enable it as a system-wide command.
CONSOLE
```
$ sudo ln -s /snap/bin/certbot /usr/bin/certbot
```

Request a new Let’s Encrypt SSL certificate using the Nginx plugin and your domain. Replace aiflow.example.com with your actual domain and admin@example.com with your active email address.

CONSOLE

$ sudo certbot --nginx --redirect -d airflow.example.com -m admin@example.com --agree-tos

Your output should be similar to the one below when the certificate request is successful.

...
Account registered.
Requesting a certificate for airflow.example.com

Successfully received certificate.
Certificate is saved at: /etc/letsencrypt/live/airflow.example.com/fullchain.pem
Key is saved at:         /etc/letsencrypt/live/airflow.example.com/privkey.pem
This certificate expires on 2025-04-21.
These files will be updated when the certificate renews.
Certbot has set up a scheduled task to automatically renew this certificate in the background.

Deploying certificate
Successfully deployed certificate for airflow.example.com to /etc/nginx/sites-enabled/airflow
Congratulations! You have successfully enabled HTTPS on https://airflow.example.com
...

Verify that Certbot auto-renews the SSL certificate before it expires.
CONSOLE
```
$ sudo certbot renew --dry-run
```
Restart Nginx to apply the SSL configuration changes.
CONSOLE
```
$ sudo systemctl restart nginx
```

Access Apache Airflow

Follow the steps below to access the Apache Airflow interface and run DAGs of your server.

Access the Apache Airflow web interface using your domain.
```
https://airflow.example.com
```
Enter the following credentials you set earlier to log in to Apache Airflow.
- Username: admin
- Password: yourSuperSecretPassword

Create and Run DAGs Using Apache Airflow

Follow the steps below to create and run a sample DAG using Apache Airflow.

Create the dags directory in the Airflow installation directory.
CONSOLE
```
$ mkdir ~/airflow/dags
```
Create a new my_first_dag.py Python application file in the dags directory.
CONSOLE
```
$ nano ~/airflow/dags/my_first_dag.py
```

Add the following code to the my_first_dag.py file to define a new DAG.

PYTHON

from airflow import DAG
from airflow.operators.python_operator import PythonOperator
from datetime import datetime, timedelta

with DAG(
    'my_first_dag',
    start_date=datetime(2024, 1, 1),
    schedule_interval=timedelta(days=1),
    catchup=False
) as dag:

    def print_hello():
        print('Greetings from Vultr')

    hello_task = PythonOperator(
        task_id='hello_task',
        python_callable=print_hello
    )

Save and close the file.

The above application code creates a my_first_dag sample DAG that runs daily and prints a Greetings from Vultr.

Navigate to the DAGs within the Apache Airflow interface. Find and enable the DAG to manually trigger it.
Use the Graph View and Event Log to monitor the DAG.

Conclusion

You have installed Apache Airflow on Ubuntu 24.04 and secured access to the application using Nginx as a reverse proxy. You can use Apache Airflow to create multiple workflows and DAGs to match your project needs.

Prerequisites Before you begin, you need to: Have access to an Ubuntu 24.04 instance with at least 4 GB RAM. Create a new domain A record pointing to the instance’s IP address. Install Apache Airflow on Ubuntu 2.04 Apache Airflow is available as a Python package you can install using a package manager such as…

Prerequisites Before you begin, you need to: Have access to an Ubuntu 24.04 instance with at least 4 GB RAM. Create a new domain A record pointing to the instance’s IP address. Install Apache Airflow on Ubuntu 2.04 Apache Airflow is available as a Python package you can install using a package manager such as…

How to Install Python 2 on FreeBSD 14

How to Install Anaconda on Ubuntu 24.04

Cobra Softwares Blog