Releases

Complete version history, release notes, and upgrade guides for all Geode releases.

Overview

This section documents the current stable release, the active development line, and the major release series that landed after the docs site was last synchronized in February 2026.

Current Release

v0.5.12 (Current Stable)

Release Date: May 7, 2026 Status: Stable patch release

Key Highlights:

  • fixes UUIDv7 generation for 32-bit ARM targets
  • includes the March 28 CTE execution and DOT output fixes
  • confirms 619/619 unit tests passing on the release line
  • continues the v0.2.x storage, QUIC, and security work started earlier in March

See Changelog for complete details.

Development Branch

main (unreleased)

The main branch can move ahead of v0.5.12. Recent follow-up areas have included:

  • engine-backed persistence only (legacy graph_store.dat removed)
  • graph name-to-UUID persistence fixes
  • free-space bitmap rebuild-on-open
  • post-open reload of graph state into memory
  • pager-level TDE page encryption wiring
  • lower-idle-CPU QUIC accept/poll behavior
  • current open-gap documentation for GAP-0270 through GAP-0272

Release Schedule

Geode follows a predictable release schedule:

  • Major Releases: Architectural changes and storage-format shifts
  • Minor Releases: New features and transport/security expansions
  • Patch Releases: Bug fixes, security hardening, and release validation

Version History

v0.2.12 - v0.2.15 (March 27-29, 2026)

  • gRPC parity fixes for RLS, auth rate limiting, CDC, and backup lock behavior
  • QUIC stream multiplexing and major poll-loop/accept-loop performance work
  • CTE execution, DOT output fixes, and cross-compilation hardening for 32-bit ARM
  • full-suite and unit-test hardening across the new storage path

v0.2.0 - v0.2.11 (March 26-27, 2026)

  • DSN graph binding and HELLO-time graph resolution
  • graph-storage engine integration with adapter bridge
  • TLS/CA certificate handling improvements and local CA auto-detection
  • security hardening for MFA, --graph, KMS tokens, metrics binding, and password handling

v0.1.11 - v0.1.39 (February 27-March 25, 2026)

  • auth graph storage, HMAC integrity verification, and offline auth maintenance commands
  • QUIC/TLS handshake, DNS, and shell keepalive fixes
  • per-graph storage isolation and backup/restore changes
  • ORDER BY large-result crash fix
  • DSN graph binding groundwork culminating in v0.1.39

v0.1.3 (January 2026)

  • original production-ready release
  • GQL compliance milestone
  • enterprise security, analytics, and operational baseline

Upgrading Geode

Before Upgrading

  1. Read Release Notes: Review changes, especially storage and transport changes
  2. Test in Staging: Upgrade a staging environment first
  3. Backup Data: Create a full backup before upgrading
  4. Check Compatibility: Verify client library, DSN, and certificate usage
  5. Review storage format changes: v0.1.28+ introduced per-graph storage; main after v0.2.15 removes the legacy monolithic path entirely

Example Docker Upgrade 

# 1. Backup
docker exec geode geode backup --output /backups/pre-upgrade.tar.gz

# 2. Pull new image
docker pull geodedb/geode:0.5.12

# 3. Stop container
docker stop geode

# 4. Start new container (data persists in volume)
docker run -d \
  -p 3141:3141 \
  -v geode-data:/var/lib/geode \
  --name geode \
  geodedb/geode:0.5.12

Compatibility

Server VersionGo ClientPython ClientRust ClientZig Client
v0.2.xrolling0.3.19+0.1.1-alpha.8+0.1.0+
v0.1.39rolling0.3.19+0.1.1-alpha.8+0.1.0+

Breaking-Change Themes

  • v0.2.x introduces graph-bound DSNs and stronger graph/session isolation semantics
  • March 2026 storage work moved from monolithic persistence toward per-graph and graph-storage-backed layouts
  • auth and security tooling now include offline graph-backed integrity workflows in addition to online login/session flows