Command reference

sparqld [OPTIONS] <DIRECTORY>

• <DIRECTORY>

  ---

  Required · Directory to serve

• --host <HOST>

  ---

  Listening address · Default 127.0.0.1

• --port <PORT>

  ---

  Listening port · Default 7737

• --no-watch

  ---

  Load once without watching for file changes

• --pattern <GLOB>

  ---

  Include or exclude source paths; repeat for multiple patterns

• -h, --help

  ---

  Show command help

• -V, --version

  ---

  Show the installed version

Combine options

Options can be composed in any order:

Command

sparqld ./examples --host 0.0.0.0 --port 8080 --no-watch

Wait for the first dataset

The listener binds while sparqld loads its first dataset. Send an ordinary query to / with a client-side timeout; it waits until that dataset is ready. The Serving … at … log line remains useful for people, but is not a client readiness contract.

Select source files

--pattern matches paths relative to the directory being served. A normal pattern includes matching supported RDF files. Prefix a pattern with ! to exclude matches. When no include patterns are supplied, every supported RDF file remains eligible, so an exclusion alone removes paths from the default set. A plain directory path matches that directory and everything below it.

For example, serve Turtle files while leaving an archive outside the dataset:

Command

sparqld ./data --pattern '**/*.ttl' --pattern '!archive'

Patterns filter source files after sparqld recognizes their extensions. A matching file with an unsupported format remains ignored. Excluded files do not appear in the file catalog. A local JSON-LD context remains available to an included source that declares it, even when the context file is excluded from the dataset.

Warning

--host 0.0.0.0 makes the endpoint reachable from the network. sparqld provides neither authentication nor TLS, so use it only behind controls that restrict access to trusted clients.