dolt-version

Display version

$ dolt version

dolt version [flags]

--help, -h
    Displays help information for the dolt version command, including available flags and usage examples, helping users understand its capabilities.

--json
    Outputs the Dolt client version and build information in a structured JSON format. This is particularly useful for scripting, automation, and integration with other tools that require programmatic access to version details.

The dolt version command outputs the installed client version of Dolt, a SQL database that supports Git-like versioning. This command is essential for users and developers to quickly identify the specific build of the Dolt client they are currently using. The output typically includes the Dolt client's build number, the git commit hash it was built from, the build date, and sometimes the platform information. This detailed version information is crucial for verifying compatibility with Dolt SQL servers, troubleshooting issues, reporting bugs accurately, and ensuring that specific features or bug fixes are present. It serves as a foundational piece of information when dealing with any Dolt-related task or support inquiry. The optional --json flag provides a machine-readable format of this information, facilitating automated checks and integrations.

The dolt version command specifically reports the client version of Dolt. It does not provide information about a connected Dolt SQL server's version, if Dolt is being used in a client-server architecture. For server version details, users should typically query the database directly (e.g., by executing SELECT VERSION() within a Dolt SQL session or client).

Beyond simple identification, version information is vital for ensuring reproducibility of environments, confirming the availability of specific Dolt features or bug fixes, and for coordinating development across teams by standardizing on particular Dolt client versions.

The --json flag makes dolt version machine-readable, enabling scripting and automation where Dolt client version checks are necessary. This is especially useful in CI/CD pipelines, deployment scripts, or automated diagnostic tools, allowing for dynamic system configurations or health checks based on the installed Dolt client version.

Dolt is developed by DoltHub, Inc. and was first publicly released in 2019, introducing a novel approach to data management by integrating Git-like version control capabilities directly into a SQL database. Its core innovation allows users to branch, merge, diff, and clone data, treating entire databases as versioned repositories. The version command has been a fundamental and indispensable part of the Dolt Command Line Interface (CLI) since its initial release, providing immediate and accessible feedback on the installed client's specific build details. Its continued presence and utility underscore the project's commitment to transparency and ease of debugging, crucial aspects for a tool bridging traditional databases with modern version control paradigms.

dolt(1), git(1), uname(1), lsb_release(1)