Configuration settings
Not available on Aura

Location of configuration settings

You can set configuration settings for the GenAI plugin via a file called genai.conf. This file must be located in the same folder as neo4j.conf (by default <NEO4J_HOME>/conf). Configuration is only possible on self-managed instances.

The genai.conf file is not created automatically when installing the GenAI plugin. You need to create manually it the first time.

List of settings

Table 1. genai.openai.baseurl

Description

Sets the base URL used by the OpenAI provider in ai.text.* functions and procedures.

Valid values

STRING

Default value

https://api.openai.com

Example genai.conf

genai.openai.baseurl=https://my-openai-proxy.example.com

Command expansion in setting values

GenAI settings can take commands as values. This is especially useful for:

  • Avoiding sensitive information in the genai.conf file as plain text.

  • Handling the configuration of instances in environments where the file system is not accessible.

Commands must begin with $ and be within parentheses (). For example: genai.setting=$(script_to_execute).

To enable command expansions, Neo4j must be started with the argument --expand-commands. Without that, commands in setting values are treated as invalid settings.

bin/neo4j start --expand-commands
The GenAI plugin uses Neo4j’s command expansion capability. See Operations Manual → The neo4j.conf file for more information.