GraphDB Command Line Tools

The GraphDB distribution includes a number of command line tools located in the /bin directory. Their file extensions are .sh or empty for Linux/Unix, and .cmd for Windows. They are described below in more detail.


This is an interactive console based on the RDF4J console.

Usage: start-console [OPTION] [repositoryID].

Use --help to see the available options, which are:




Always answer no to (suppressed) confirmation prompts

-d,--dataDir <arg>

Sesame data directory to ‘connect’ to


Echoes input back to stdout, useful for logging script sessions


Always answer yes to (suppressed) confirmation prompts


Print this help


Suppresses prompts, useful for scripting

-s,--serverURL <arg>

URL of Sesame server to connect to, e.g., http://localhost/openrdf-sesame/


Print version information


Immediately exit the console on the first error


The convert-repo tool is used converting the repository configuration from one GraphDB edition to another.

Usage: convert-repo -t <type> <data-dir>.

Use --help to see the available options, which are:




The desired repository type, one of ‘free’, ‘se’, or ‘ee-worker’


The data directory of the repository, e.g., data/repositories/myrepo


This tool is used to generate a zip with report about a GraphDB server. On startup, graphdb -p specifies a PID file to which to write the process ID, which is needed by this tool.

Usage: <graphdb-pid> [<output-file>].

The available options are:




(Required) The process ID of a running GraphDB instance.


(Optional) The path of the file where the report should be saved. If this option is missing, the report will be saved in a file called in the current directory.


The graphdb command line tool starts the database. See more about its command line options here.


The tool is used for incremental backup rebuild.

Use --help to see the available options, which are:



ibrtool -l[ist]

List all incremental backups that can be rebuilt for the master nodes located in the folder

ibrtool -m[aster] <masterid> <incremental backup name>

Rebuild the incremental backups for the master

ibrtool <source folder> <target folder>

Rebuild incremental backups based on locations supplied as arguments


The loadrdf tool is used for offline loading of datasets. See more about its command line options here.


The ontorefine-cli tool can be used for most of the main functionalities of the OntoRefine UI in the Workbench. Through it, you can create/export/delete OntoRefine projects, as well as apply and extract transformations made to them and reconcile data against other databases. See more about it here.


The preload tool is used for converting RDF files into GraphDB indexes on a very low level. See more about its command line options here.


Used for validating RDF files.

Usage: rdfvalidator <input-folder-or-file-with-rdf-files>.


This tool converts standard RDF reification to RDF-star. The output file must be an RDF-star format.

Usage: reification-convert [--relaxed] <input-file1> [<input-file2> ...] <output-file>.

Available options:




Enables relaxed mode where x a rdf:Statement is not required.


Usage: rule-compiler <rules.pie> <java-class-name> <output-class-file> [<partial>].

Available options:




The name of the rule .pie file


The name of the Java class


The output file name




The storage-tool is used for scanning and repairing a GraphDB repository. See more about its command line options here.