dgraph/dgraph repository overview

(Dockerfile source⁠)

The Only Native GraphQL Database With A Graph Backend.

Dgraph is a horizontally scalable and distributed GraphQL database with a graph backend. It provides ACID transactions, consistent replication and linearizable reads. It's built from ground up to perform for a rich set of queries. Being a native GraphQL database, it tightly controls how the data is arranged on disk to optimize for query performance and throughput, reducing disk seeks and network calls in a cluster.

Dgraph's goal is to provide Google⁠ production level scale and throughput, with low enough latency to be serving real time user queries, over terabytes of structured data.

Dgraph supports GraphQL query syntax⁠, and responds in JSON⁠ and Protocol Buffers⁠ over GRPC⁠ and HTTP.

⁠Install with Docker

If you're using Docker, you can use the official Dgraph image⁠.

docker pull dgraph/dgraph:latest

⁠Install from Source

If you want to install from source, install Go 1.22+ or later and the following dependencies:

Ubuntu:

sudo apt-get update
sudo apt-get install gcc make

Then clone the Dgraph repository and use make install to install the Dgraph binary to $GOPATH/bin.

git clone https://github.com/dgraph-io/dgraph.git
cd ./dgraph
make install

⁠Get Started

To get started with Dgraph, follow:

• Installation to queries in 3 steps via dgraph.io/docs/⁠.
• A longer interactive tutorial via dgraph.io/tour/⁠.
• Tutorial and presentation videos on YouTube channel⁠.

⁠Is Dgraph the right choice for me?

• Do you have more than 10 SQL tables, connected to each other via foreign keys?
• Do you have sparse data, which doesn't elegantly fit into SQL tables?
• Do you want a simple and flexible schema, which is readable and maintainable over time?
• Do you care about speed and performance at scale?

If the answers to the above are YES, then Dgraph would be a great fit for your application. Dgraph provides NoSQL like scalability while providing SQL like transactions and ability to select, filter and aggregate data points. It combines that with distributed joins, traversals and graph operations, which makes it easy to build applications with it.

⁠Users

• Dgraph official documentation is present at dgraph.io/docs/⁠.
• For feature requests or questions, visit github.com/dgraph-io/dgraph⁠.
• Check out the demo at dgraph.io⁠ and the visualization at play.dgraph.io⁠.
• Please see releases tab⁠ to find the latest release and corresponding release notes.
• Read about the latest updates from Dgraph team on our blog⁠.
• Watch tech talks on our YouTube channel⁠.

⁠Developers

• Please see Contributing to Dgraph⁠ for guidelines on contributions.

⁠Client Libraries

The Dgraph team maintain a number of officially supported client libraries⁠. There are also libraries contributed by the community unofficial client libraries⁠.