Version Control
Branch, clone, merge, diff, patch, time-travel, and collaboration
Subtopics
35 pages
Audit Data Changes
Step-by-step tutorial to audit who changed what and when using TerminusDB's immutable commit log. Query history, diff commits, and trace field-level changes.
Git-like version control for JSON data
TerminusDB gives JSON documents Git-like version control — structural diff, patch, branches, and full commit history. Store schemaless JSON with automatic deduplication. Tutorial with curl examples.
Recover Data from Version History
Step-by-step tutorial to recover deleted or corrupted data using TerminusDB's immutable commit history. View the log, branch from a known-good commit, and reset.
Your First 10 Minutes with TerminusDB
Run TerminusDB with one Docker command, clone a sample dataset, then branch, diff and merge it. The full git-for-data workflow in 10 minutes, no sign-up.
Branch a Project with the TerminusDB Dashboard
A guide to show how to branch projects using the TerminusDB dashboard.
Clone a Project using the TerminusDB Dashboard
A guide to show how to clone a project using the TerminusDB dashboard.
History & Branching in Versioned Search
Per-commit snapshots, branch-out with block reuse, reassignment, and staleness handling
How to Branch Your Database
Step-by-step guide to database branching in TerminusDB — create, list, switch, diff, merge, and delete branches with HTTP API, TypeScript, and Python examples.
How to Merge Branches
Step-by-step guide to merging branches in TerminusDB — apply changes, detect conflicts, resolve them, and roll back failed merges. HTTP API, TypeScript, and Python examples.
How to Time-Travel (Query Historical Data)
Run time travel queries in TerminusDB — get commit history, query at a specific commit, compare points in time and restore. HTTP, TypeScript, Python.
How to Undo Changes (Reset, Revert, Squash)
Step-by-step guide to undoing changes in TerminusDB — reset to a previous commit, revert specific changes, squash commits, and understand the difference between reset and revert. HTTP API, TypeScript, and Python examples.
How to Version JSON Data in an Application Database
Version JSON documents with Git-style commits, branches, diffs and full history. Step-by-step guide with runnable curl and TypeScript examples against TerminusDB.
Manual reverse branch cloning
How to manually clone branches between data products
Perform a Delta Rollup
How delta rollup works in TerminusDB. Automatic in standard deployments via the built-in rollup plugin — manual optimisation is available for custom deployments.
Querying Layers with GraphQL
Learn how to query TerminusDB layer objects using GraphQL to navigate version control history and repository structure.
Reset a Branch to a Previous Commit
How to reset a TerminusDB branch to a specific commit using the JavaScript client, Python client, or HTTP API.
Reset a Project with the TerminusDB Dashboard
A guide to show how to reset to a particular commit of a branch or main using the TerminusDB dashboard.
Set Commit Messages on Document Operations
How to set author and message on document writes so the commit log records who made the change and why.
Squash Commits on a Branch
How to squash multiple commits into one using the JavaScript client, Python client, or HTTP API.
Squash Commits with the TerminusDB Dashboard
A guide to show how to squash the commits of a branch or main into one large commit using the TerminusDB dashboard.
Time Travel using TerminusDB Cloud dashboard
A guide to show how to time travel to any previous commit using TerminusDB Cloud dashboard.
Git-for-Data Reference
Complete reference for Git-for-Data operations in TerminusDB — push, pull, fetch, clone, rebase, and remote management with HTTP API, TypeScript, and Python examples.
Version Control Operations — Git for Data
TerminusDB is a git for data database. Complete reference for git-based version control operations — branch, merge, diff, time-travel, reset, and squash with HTTP API examples and expected responses.
A Graph Database with Git-like Version Control for Production Data
Database version control for production data — Git-style commits, branches, diffs, merges and clone/push/pull, built into the TerminusDB graph database engine.
A Graph Database with Time Travel Queries
TerminusDB keeps every write as an immutable commit, so you can query your graph as it was at any commit or branch. No backups or log replay.
A Knowledge Graph for AI Agents with Git-style Branching
Use TerminusDB as a knowledge graph for AI agents. Give each agent run its own branch, review the diff, merge it, and query past facts at any commit.
Knowledge Graph Database with Git-like Version Control
An instructional overview of TerminusDB as a git-for-data knowledge graph database — covering commits, branches, merges, rollback, diff and patch, time travel, and the similarities and differences with Git.
Knowledge Graph Diff
A knowledge graph diff shows which facts changed between two versions. Triple vs document diffs, and how to diff and patch a graph in TerminusDB.
Knowledge Graph Versioning
What knowledge graph versioning is, four ways to do it, the snapshot vs delta trade-off, and a short working example with TerminusDB.
Ontology Versioning
How to version an ontology or knowledge graph schema, breaking vs non-breaking changes, and how to change a class on a branch and migrate the data.
TerminusDB 11.0.1: Local Clone and Pre-Commit Hooks
TerminusDB 11.0.1 lets you clone a database locally without a remote and run pre-commit schema checks, so offline work and validation get easier.
TerminusDB 11.0.4: The Document History API
TerminusDB 11.0.4 lets you ask when a document changed through the history API, so audit trails need no manual bookkeeping. Also: experimental migrations.
TerminusDB 11.1.0: Semantic Indexer and Layer Concat
TerminusDB 11.1.0 lets you run semantic similarity search with the VectorLink indexer, so you can find documents by meaning. Also: layer concat.
TerminusDB 12.0.5: Streaming History with Diffs
TerminusDB 12.0.5 lets you stream document history with per-commit diffs, so audits show what changed when. Also: group_by on compound values.
TerminusDB 12.0.7: Resolve Merge Conflicts with Insert and Delete Patches
TerminusDB 12.0.7 lets the patch endpoint insert and delete documents, so you can resolve merge conflicts in one commit. Also: folded diffs, Elixir client.