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.

Grai Core logo

Self-host Grai Core

v0.1.76

Open-source data lineage and metadata platform

BetaOpen SourceMIT-0
Updated2 years ago
LanguagePython
Setup difficultyModerate
Stars
317
Port
8000 (backend API server)
Requires
PostgreSQL, Redis
Docker
ghcr.io/grai-io/grai-core/grai-server
Install with Docker Compose
Grai web application showing lineage graph

What is Grai Core?

Grai is an open-source data lineage platform that helps data teams map how their data connects across different systems. It provides pre-built connectors for popular data sources including Snowflake, BigQuery, Redshift, PostgreSQL, MySQL, SQL Server, dbt, Fivetran, Metabase, and Looker. The platform automatically synchronizes lineage metadata and supports centralized data validation tests that run when upstream sources change. It integrates with GitHub Actions for CI/CD validation. Grai can be self-hosted using Docker Compose, Helm charts, or the Grai CLI, and consists of a Django/PostgreSQL backend server, a React frontend, a Python CLI client, and integration libraries. The default deployment includes PostgreSQL with pgvector, Redis, a backend API server on port 8000, a frontend on port 3000, and Celery workers for background tasks.

Should you self-host Grai Core?

Grai Core scores 47/100 on selfhost.directory (how scoring works) and ranks #7 of 8 in Data Pipeline. It has 317 GitHub stars.

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

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is apache-nifi (73/100, 6 277 stars). It scores higher overall, so compare the two before you pick. See Grai Core vs apache-nifi side by side.

Features

  • Centralized data tests
  • Column-level data lineage
  • Docker Compose Deployment
  • GitHub Actions Integration
  • Metadata schema library
  • Pre-built Connectors
  • Python CLI client
  • Web-based lineage graph

Grai Core README

How to install Grai Core

Install Grai Core with Docker Compose

Docker and Docker Compose
Environment variables
DB_HOST, DB_PORT, DB_NAME, DB_USER, DB_PASSWORD, DJANGO_SUPERUSER_USERNAME, DJANGO_SUPERUSER_PASSWORD, DJANGO_SUPERUSER_WORKSPACE, SERVER_HOST, FRONTEND_HOST, FRONTEND_URL, REDIS_HOST, REACT_APP_API_URL

git clone https://github.com/grai-io/grai-core cp examples/deployment/docker-compose/docker-compose.yml docker compose up

Minimal deployment with PostgreSQL, Redis, backend, frontend, and Celery workers

How to configure Grai Core

  • DB_HOSTdbPostgreSQL host

    PostgreSQL host

  • DB_NAMEgraiPostgreSQL database name

    PostgreSQL database name

  • DB_PASSWORDgraiPostgreSQL password

    PostgreSQL password

  • DB_PORT5432PostgreSQL port

    PostgreSQL port

  • DB_USERgraiPostgreSQL username

    PostgreSQL username

  • DJANGO_SUPERUSER_PASSWORDsuper_secretDefault admin password

    Default admin password

  • DJANGO_SUPERUSER_USERNAMEnull@grai.ioDefault admin username

    Default admin username

  • DJANGO_SUPERUSER_WORKSPACEdefaultDefault workspace name

    Default workspace name

  • FRONTEND_HOSTlocalhostFrontend host

    Frontend host

  • FRONTEND_URLhttp://localhost:3000Frontend URL

    Frontend URL

  • REACT_APP_API_URLhttp://localhost:8000Frontend API URL

    Frontend API URL

  • REDIS_HOSTredisRedis host

    Redis host

  • SERVER_HOSTlocalhostBackend server host

    Backend server host

Grai Core releases & version history

More in Data Pipeline

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…