PreviewMemGQLConfiguration

Configuration

MemGQL is configured entirely via environment variables.

General

VariableDefaultDescription
CONNECTOR_TYPEmemgraphConnector to use (see table below)
BOLT_LISTEN_ADDR127.0.0.1:7688Address the Bolt server binds to

Enterprise License

VariableDefaultDescription
MEMGQL_ENTERPRISE_LICENSE(none)License key (mglk-...)
MEMGQL_ORGANIZATION_NAME(none)Organization name to verify against license

When set, the license is decoded and verified against the organization name at startup. A valid enterprise license removes connector and connection limits. Without a license, community mode allows up to 4 connectors and 4 simultaneous connections.

Connector Types

ConnectorTranslationBackend
memgraphNone (passthrough)Memgraph
memgraph-gqlGQL -> CypherMemgraph
neo4jNone (passthrough)Neo4j
neo4j-gqlGQL -> CypherNeo4j
postgresGQL -> SQLPostgreSQL
duckdbGQL -> SQLDuckDB (embedded)
icebergGQL -> SQLIceberg via Trino
multiPer-connectorMultiple backends simultaneously

Memgraph (memgraph, memgraph-gql)

VariableDefaultDescription
MEMGRAPH_URI127.0.0.1:7687Connection URI
MEMGRAPH_USERuserUsername
MEMGRAPH_PASSpassPassword
MEMGRAPH_DBmemgraphDatabase name

Neo4j (neo4j, neo4j-gql)

VariableDefaultDescription
NEO4J_URI127.0.0.1:7687Connection URI
NEO4J_USERneo4jUsername
NEO4J_PASSpasswordPassword
NEO4J_DBneo4jDatabase name

PostgreSQL (postgres)

VariableDefaultDescription
POSTGRES_URLhost=localhost user=postgres password=postgres dbname=postgreslibpq connection string
MAPPING_FILE(none, uses built-in default)Path to JSON mapping file

DuckDB (duckdb)

VariableDefaultDescription
DUCKDB_PATH:memory:Path to DuckDB file
MAPPING_FILE(none, uses built-in default)Path to JSON mapping file

Iceberg (iceberg)

VariableDefaultDescription
TRINO_URLhttp://localhost:8080Trino REST API URL
TRINO_USERtrinoTrino user
TRINO_CATALOGicebergTrino catalog
TRINO_SCHEMAdefaultTrino schema
MAPPING_FILE(none, uses built-in default)Path to JSON mapping file
to PostgreSQLChangelog