Skip to main content

Distributed SQL for Mission-Critical Applications

YugabyteDB is a PostgreSQL-compatible distributed SQL database that combines transactional consistency with horizontal scalability. Build applications that require absolute data correctness at any scale.

YugabyteDB Architecture

Quick start

Get YugabyteDB running locally in minutes

1

Install YugabyteDB

Download and install YugabyteDB using the yugabyted utility:
wget https://downloads.yugabyte.com/releases/2025.1.0.0/yugabyte-2025.1.0.0-linux-x86_64.tar.gz
tar xvfz yugabyte-2025.1.0.0-linux-x86_64.tar.gz && cd yugabyte-2025.1.0.0/
./bin/yugabyted start
2

Connect with YSQL

Connect to your cluster using the PostgreSQL-compatible YSQL API:
./bin/ysqlsh
You’ll see a PostgreSQL prompt ready for SQL commands.
3

Create your first table

Create a distributed table and insert data:
CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  username VARCHAR(50) UNIQUE NOT NULL,
  email VARCHAR(100) NOT NULL,
  created_at TIMESTAMP DEFAULT NOW()
);

INSERT INTO users (username, email) 
VALUES ('alice', '[email protected]');

SELECT * FROM users;
4

Explore distributed features

View tablet distribution across nodes:
SELECT * FROM yb_local_tablets;
Your data is automatically sharded and replicated across nodes for high availability.

Explore by topic

Learn about YugabyteDB’s core capabilities and how to use them

Core concepts

Understand YugabyteDB’s distributed architecture, data model, and transaction guarantees

Deploy anywhere

Run on Docker, Kubernetes, or cloud providers with multi-region support

Build applications

Connect using PostgreSQL drivers and ORMs in Java, Python, Node.js, Go, and more

Operations guide

Backup, restore, monitor, and tune your production clusters

Secure your data

Configure authentication, authorization, and encryption for enterprise security

Advanced features

Use CDC, xCluster replication, read replicas, and vector search with pgvector

API reference

Complete reference for SQL APIs, drivers, and CLI tools

YSQL API

PostgreSQL-compatible SQL API with distributed transactions

YCQL API

Cassandra-compatible API for semi-relational workloads

Client drivers

Native drivers for Java, Python, Node.js, Go, and C++

yugabyted

Cluster management CLI for local and production deployments

ysqlsh

Interactive PostgreSQL shell for YSQL queries

yb-admin

Advanced cluster administration and debugging tool

Resources and community

Get help, connect with other users, and stay up to date

Community Slack

Join our Slack community to ask questions and share knowledge

Discussion forum

Browse discussions, RFCs, and design proposals

GitHub repository

Report issues, request features, and contribute code

Stack Overflow

Find answers to common questions and troubleshooting tips

Ready to build with YugabyteDB?

Start with our quick start guide or explore the full documentation to learn how to deploy, develop, and operate YugabyteDB at scale.

Get Started Now