How to Install Apache Doris on Ubuntu 24.04 LTS: Step-by-Step Guide

With the explosive growth of real-time analytics and big data applications, high-performance OLAP databases have become essential. Apache Doris, an open-source MPP (Massively Parallel Processing) analytical database, stands out as a top choice for handling high-concurrency, low-latency query scenarios on large-scale data.

In this step-by-step guide, we’ll show you how to install Apache Doris on Ubuntu 24.04 LTS, the latest long-term support version of Ubuntu. Whether you’re a data engineer, developer, or tech enthusiast, this tutorial will help you get started with Apache Doris quickly and effectively.

🔍 What Is Apache Doris?

Apache Doris is a real-time, high-performance analytical database designed for interactive reporting and data warehousing. It supports high-throughput data ingestion, low-latency queries, and flexible schema definitions. It’s widely used for BI, OLAP, and real-time dashboards.

Key Features:

• Distributed architecture with high scalability
• Supports standard SQL
• Real-time data ingestion via Kafka, Flink, etc.
• Built-in vectorized execution engine
• Seamless integration with data tools like Superset, Grafana, and Spark

🧰 Prerequisites

Before installing Apache Doris on Ubuntu 24.04 LTS, ensure your system meets the following requirements:

System Requirements:

• Ubuntu 24.04 LTS (minimal install or server edition)
• At least 2 CPU cores and 4GB RAM (8GB+ recommended)
• Java 8+ (OpenJDK recommended)
• GCC 7+
• CMake 3.14+
• Git, Python 3, and other build dependencies

⚠️ Apache Doris consists of two major components: FE (Frontend) and BE (Backend). For testing or local development, both can be installed on a single node.

⚙️ Step-by-Step Installation Guide

Step 1: Update Your System

sudo apt update && sudo apt upgrade -y

Step 2: Install Required Dependencies

sudo apt install -y build-essential git cmake openjdk-11-jdk python3 unzip wget

Verify Java version:

It should return Java 11 or higher.

Step 3: Download Apache Doris Source Code

Go to the official Apache Doris GitHub repository or use the command below to clone it:

git clone https://github.com/apache/doris.git
cd doris

🔖 As of 2025, Doris 2.x is the latest stable version. Always check the official release page for the newest tags.

java -version

Step 4: Build Doris Components

Apache Doris uses Apache Maven and CMake to build. You’ll need to compile both FE and BE.

4.1 Compile the Backend (BE)

./build.sh --be

This process may take several minutes, depending on your hardware.

4.2 Compile the Frontend (FE)

./build.sh --fe

After successful compilation, Doris will generate output/ folders for FE and BE components.

Step 5: Configure Apache Doris

Create a directory for deployment:

mkdir -p ~/doris-deploy/fe ~/doris-deploy/be

Copy the compiled binaries:

cp -r output/fe/* ~/doris-deploy/fe/
cp -r output/be/* ~/doris-deploy/be/

Edit the configuration files:

Frontend Configuration

nano ~/doris-deploy/fe/conf/fe.conf

Set parameters such as:

priority_networks = 127.0.0.1/24
http_port = 8030
rpc_port = 9020
query_port = 9030
edit_log_port = 9010

Backend Configuration

nano ~/doris-deploy/be/conf/be.conf

Example config:

priority_networks = 127.0.0.1/24
be_port = 9060
webserver_port = 8040
heartbeat_service_port = 9050

Step 6: Start Apache Doris Services

Start the Frontend

cd ~/doris-deploy/fe
bin/start_fe.sh --daemon

Start the Backend

cd ~/doris-deploy/be
bin/start_be.sh --daemon

Check status:

ps aux | grep doris

Step 7: Access Apache Doris

You can now access the Doris web interface at:

http://localhost:8030

Use the MySQL client to connect via terminal:

mysql -h 127.0.0.1 -P 9030 -uroot

Create a test database:

CREATE DATABASE test_db;
SHOW DATABASES;

🧪 Optional: Use Docker for Quick Deployment

For a quicker setup or testing environment, Apache Doris provides official Docker images:

docker pull apache/doris:latest

Start a container:

docker run -d -p 8030:8030 -p 9030:9030 apache/doris:latest

This is ideal for demos, development, or trying out features without manual compilation.

🛠️ Troubleshooting Tips

Problem	Solution
Java not found or incompatible	Ensure OpenJDK 11+ is installed
Ports already in use	Edit fe.conf and be.conf to change ports
BE not registering with FE	Check IP settings and make sure priority networks are correct
Build errors	Check IP settings and make sure priority networks are correct

✅ Conclusion

Apache Doris is a powerful OLAP database that’s ideal for modern analytics workloads. In this guide, you’ve learned how to install Apache Doris on Ubuntu 24.04 LTS from source, configure its components, and run it locally. Whether you’re building a data lakehouse, real-time dashboard, or reporting platform, Doris delivers blazing-fast performance and scalability.