starrocks README

The project's README from github.com/StarRocks/starrocks. As one markdown file: README.md.

Download | Docs | Benchmarks | Demo

JAVA&C++ Commit Activities Open Issues Website Slack Twitter Gurubase

StarRocks is the world's fastest open query engine for sub-second, ad-hoc analytics both on and off the data lakehouse. With average query performance 3x faster than other popular alternatives, StarRocks is a query engine that eliminates the need for denormalization and adapts to your use cases, without having to move your data or rewrite SQL. A Linux Foundation project.

Learn more 👉🏻 What Is StarRocks: Features and Use Cases, Join StarRocks Summit 2025!



Features


Architecture Overview

StarRocks’s streamlined architecture is mainly composed of two modules: Frontend (FE) and Backend (BE). The entire system eliminates single points of failure through seamless and horizontal scaling of FE and BE, as well as replication of metadata and data.

Starting from version 3.0, StarRocks supports a new shared-data architecture, which can provide better scalability and lower costs.


Resources

📚 Read the docs

Section Description
Quick Starts How-tos and Tutorials.
Deploy Learn how to run and configure StarRocks.
Docs Full documentation.
Blogs StarRocks deep dive and user stories.

❓ Get support


Contributing to StarRocks

We welcome all kinds of contributions from the community, individuals and partners. We owe our success to your active involvement.

  1. See Contributing.md to get started.
  2. Set up StarRocks development environment:
  1. Understand our GitHub workflow for opening a pull request; use this PR Template when submitting a pull request.
  2. Pick a good first issue and start contributing.

📝 License: StarRocks is licensed under Apache License 2.0.

👥 Community Membership: Learn more about different contributor roles in StarRocks community.

💬 Developer Group: Please join our Google Groups to discuss StarRocks features, project directions, issues, pull requests, or share suggestions.


Used By

This project is used by the following companies. Learn more about their use cases:

starrocks (StarRocks/starrocks)

lakehouse
Searching Database…

12.2K ·GitHub
What is this?StarRocks is an open-source, high-performance query engine for sub-second, ad-hoc analytics on data warehouses and data lakes, built as a Linux Foundation project.
Is this a database I deploy myself, or a hosted service?It is a self-hosted analytical database you run on your own cluster, made of two components: a Frontend (FE) for metadata and query planning, and a Backend (BE) for storage and execution.
How do I get it running?Follow the Quick Starts and Deploy guides in the docs; you can compile StarRocks with Docker or deploy a cluster manually.
Do I need Hive, Iceberg, or Delta Lake already set up to use it?No, those are optional - StarRocks works as a standalone database, but it can also query data directly in Hive, Iceberg, Delta Lake, and Hudi without importing it first.
How complex is it to deploy and maintain a cluster?It's a distributed system, but the architecture is designed to be simple: it tunes query plans automatically, rebalances resources when nodes are added or removed, and recovers replicas after node failure on its own.
Who is this built for?Teams running multi-dimensional, real-time, or ad-hoc analytics at scale; it's used in production by companies like Airbnb, Pinterest, Tencent, Trip.com, and Xiaohongshu.
What makes StarRocks' queries so fast?It uses a native vectorized SQL engine that fully exploits CPU parallelism, giving sub-second query returns that are 5 to 10 times faster than previous-generation systems.
Can I connect my existing BI tools to it?Yes - StarRocks supports ANSI SQL and is compatible with the MySQL protocol, so most SQL clients and BI software can connect to it directly.
How does real-time data updating work?StarRocks uses a primary-key update model that supports efficient upsert and delete operations even while queries run concurrently.
What changed with the shared-data architecture in v3.0?Starting from version 3.0, StarRocks added a shared-data architecture (separating storage and compute) to provide better scalability and lower costs than the original shared-nothing design.
What are similar projects?doris, trino, ClickHouse, druid, oceanbase, questdb, tidb, vitess
Creator
StarRocks
Size
755.7 MB
Stars
12.2K
Age
5y
Commits · 90 Days