version | CLI commands

Output the version of the database component, or the version of a remote server. The launcher has its own version commands, described below.

Usage

surreal db version [OPTIONS]

Options

Name	Default	Environment variable	Description
`--endpoint, -e<ENDPOINT>`	None	None	Remote database server URL to connect to. When given, only the server's version number is printed.
`--json, -j`	None	None	From 4.0.0. Print the version as one JSON document on stdout, with the keys `arch`, `os` and `version`, and a `server` object holding the server's `version` when `--endpoint` is given.
`--log, -l<LOG>`	`info`	`SURREAL_LOG`	The logging level for the command-line tool. Possible values: `none`, `full`, `error`, `warn`, `info`, `debug`, `trace`.

Example usage

To display the version of the database component, along with the platform and architecture, run surreal db version without any further arguments.

surreal db version

Sample output:

4.0.0 for macos on aarch64

If an endpoint is specified, only the version number of the server is displayed.

surreal db version --endpoint http://localhost:8000

Output:

4.0.0

Launcher versions

surreal list and surreal --version belong to the launcher and do not forward to the database. surreal list prints a table with each component, the version that runs, where that version came from, and its path. surreal --version prints the launcher's own version.

surreal list

Sample output

COMPONENT  VERSION  SOURCE  INSTALLED  PATH
cli        1.0.0    cli                /usr/local/bin/surreal
db         4.0.0    pinned  4.0.0      /home/you/.surrealdb/components/db/4.0.0/surreal-db
ext
cloud      1.0.0    pinned  1.0.0      /home/you/.surrealdb/components/cloud/1.0.0/surreal-cloud
lsp
memory

surreal --version

Sample output

1.0.0 for macos on aarch64

A component that is not installed has a blank row in the table. To query a server, or to print the database version alone, use surreal db version. surreal version without db is the deprecated form of surreal db version, so it prints the database version and a warning that names the replacement. See the launcher reference for the other version commands, including surreal install, surreal use and surreal upgrade.

Command help

To see the help information and usage instructions, in a terminal run the surreal db version --help command without any further arguments. This command gives general information on the arguments, inputs, and additional options for the version command.

surreal db version --help

The output of the above command:

Output the command-line tool and remote server version information

Usage: surreal version [OPTIONS]

Options:
  -e, --endpoint <ENDPOINT>  Remote database server url to connect to
  -j, --json                 Emit machine-readable JSON on stdout
  -h, --help                 Print help

Logging:
  -l, --log <LOG>                              The logging level for the command-line tool [env: SURREAL_LOG] [default: info] [possible
                                               values: none, full, error, warn, info, debug, trace]
      --log-format <LOG_FORMAT>                The format for terminal log output [env: SURREAL_LOG_FORMAT] [default: text] [possible
                                               values: text, json]
      --log-socket <LOG_SOCKET>                Send logs to the specified host:port [env: SURREAL_LOG_SOCKET]
      --log-file-level <LOG_FILE_LEVEL>        Override the logging level for file output [env: SURREAL_LOG_FILE_LEVEL] [possible values:
                                               none, full, error, warn, info, debug, trace]
      --log-otel-level <LOG_OTEL_LEVEL>        Override the logging level for OpenTelemetry output [env: SURREAL_LOG_OTEL_LEVEL] [possible
                                               values: none, full, error, warn, info, debug, trace]
      --log-socket-level <LOG_SOCKET_LEVEL>    Override the logging level for unix socket output [env: SURREAL_LOG_SOCKET_LEVEL] [possible
                                               values: none, full, error, warn, info, debug, trace]
      --log-socket-format <LOG_SOCKET_FORMAT>  The format for socket output [env: SURREAL_LOG_SOCKET_FORMAT] [default: text] [possible
                                               values: text, json]
      --log-file-enabled                       Whether to enable log file output [env: SURREAL_LOG_FILE_ENABLED]
      --log-file-path <LOG_FILE_PATH>          The directory where log files will be stored [env: SURREAL_LOG_FILE_PATH] [default: logs]
      --log-file-name <LOG_FILE_NAME>          The name of the log file [env: SURREAL_LOG_FILE_NAME] [default: surrealdb.log]
      --log-file-format <LOG_FILE_FORMAT>      The format for log file output [env: SURREAL_LOG_FILE_FORMAT] [default: text] [possible
                                               values: text, json]
      --log-file-rotation <LOG_FILE_ROTATION>  The log file rotation interval [env: SURREAL_LOG_FILE_ROTATION] [default: daily] [possible
                                               values: daily, hourly, never]