selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Gel logo

Self-host Gel

v7.0

Graph-relational database that supercharges Postgres

ReleaseOpen SourceApache-2.0
docker run --name gel -d -e GEL_SERVER_SECURITY=insecure_dev_mode geldata/gel
Updated10 months ago
LanguagePython
Setup difficultyEasy
MobileResponsive
Stars
14 188
Port
5656 (Gel server endpoint (binary protocol and HTTP); listen_port default)
Docker
geldata/gel
Query editor showing a query result in table formatQuery editor with visual analyse output for an analyse querySchema viewer with text and graph representation of the schemaData explorer drilling down into a rowQuery performance statistics UI with execution time histogram

What is Gel?

Gel is an open-source graph-relational database server built on PostgreSQL, aimed at developers who want a richer data model than plain tables. Its schema language defines object types holding properties and connected by links, and its EdgeQL query language returns nested objects instead of flat rows, supporting composition, polymorphism and computed fields; the server also speaks SQL and GraphQL and is reachable over its binary protocol or HTTP. Schema evolution uses a purpose-built migration engine plus database branching, while opt-in extensions add application-facing authentication (OAuth, password, magic links, passkeys and a built-in sign-in UI) and AI capabilities such as automatic embeddings, a vector store and a ready-made RAG endpoint. A bundled web interface, opened with the gel command or GEL_SERVER_ADMIN_UI, provides a schema viewer, data editing, a query IDE, performance views and AI/Auth configuration. Self-hosting is documented through the official geldata/gel Docker image (port 5656 by default), Docker Compose examples, or the gel-server binary installed and managed by the Gel CLI on Linux/macOS; Windows needs WSL 2. The core server and its auth layer are fully open source under Apache 2.0; hosting is also offered as the separate managed Gel Cloud service, and the project's site announces Gel joining Vercel.

Should you self-host Gel?

Gel scores 71/100 on selfhost.directory (how scoring works) and ranks #13 of 38 in Databases. It has 14 188 GitHub stars, +11 in the last 30 days.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Redis (86/100, 77 490 stars). It scores higher overall, so compare the two before you pick. See Gel vs Redis side by side.

Features

  • Access control & policies
  • AI embeddings & RAG
  • Built-in application auth
  • CLI & interactive shell
  • Code Generation
  • Connection Pooling
  • Database branching
  • EdgeQL query language
  • GraphQL Support
  • Graph-relational data model
  • REST-style HTTP interface
  • Schema migrations
  • SQL & ORM support
  • Vector store
  • Web admin UI

Gel README

How to install Gel

Install Gel with Docker

Official image "geldata/gel" packaging Gel and the Gel CLI
Environment variables
GEL_SERVER_SECURITY, GEL_SERVER_PASSWORD, GEL_SERVER_TLS_CERT_MODE, GEL_SERVER_DATADIR, GEL_SERVER_BACKEND_DSN
docker run --name gel -d \
  -e GEL_SERVER_SECURITY=insecure_dev_mode \
  geldata/gel

Persist data by mounting a volume at GEL_SERVER_DATADIR (/var/lib/gel/data by default).

How to configure Gel

  • GEL_SERVER_PASSWORDPassword for the default superuser account (or GEL_SERVER_USER); ignored if GEL_SERVER_BOOTSTRAP_COMMAND is set. _FILE/_ENV variants supported.

    values: string

  • GEL_SERVER_PASSWORD_HASHVariant of GEL_SERVER_PASSWORD where the value is a hashed password verifier instead of plain text.

    values: string

  • GEL_SERVER_DATADIR/var/lib/gel/dataPath where database files are stored; cannot be combined with GEL_SERVER_BACKEND_DSN.

    values: path

  • GEL_SERVER_BACKEND_DSNPostgreSQL connection URI; uses an external Postgres cluster instead of the builtin one.

    values: URI string

  • GEL_SERVER_PORT5656Network port Gel listens on; maps to gel-server flag --port.

    values: int

Gel releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Databases

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…