Software Updates & Releases

Keeping your Geode database deployment current ensures you benefit from the latest features, performance improvements, security patches, and bug fixes. Geode follows semantic versioning and provides clear upgrade paths with comprehensive release documentation. <h3 id="release-cycle-and-versioning" class="position-relative d-flex align-items-center group"> Release Cycle and Versioning <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="release-cycle-and-versioning" aria-haspopup="dialog" aria-label="Share link: Release Cycle and Versioning"> Share link </button> </h3><div id="headingShareModal" class="heading-share-modal" role="dialog" aria-modal="true" aria-labelledby="headingShareTitle" hidden> <div class="hsm-dialog" role="document"> <div class="hsm-header"> <h2 id="headingShareTitle" class="h6 mb-0 fw-bold">Share this section</h2> <button type="button" class="hsm-close" aria-label="Close"> </button> </div> <div class="hsm-body"> <label for="headingShareInput" class="form-label small text-muted mb-1 text-uppercase fw-bold" style="font-size: 0.7rem; letter-spacing: 0.5px;">Permalink</label> <div class="input-group mb-4 hsm-url-group"> <input id="headingShareInput" type="text" class="form-control font-monospace" readonly aria-readonly="true" style="font-size: 0.85rem;" /> <button class="btn btn-primary hsm-copy" type="button" aria-label="Copy" title="Copy"> </button> </div> <div class="small fw-bold mb-2 text-muted text-uppercase" style="font-size: 0.7rem; letter-spacing: 0.5px;">Share via</div> <div class="hsm-share-grid"> <a id="share-twitter" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> Twitter </a> <a id="share-linkedin" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> LinkedIn </a> <a id="share-facebook" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> Facebook </a> </div> </div> </div> </div> <style> .heading-share-modal { position: fixed; inset: 0; display: flex; justify-content: center; align-items: center; background: rgba(0, 0, 0, 0.6); z-index: 1050; padding: 1rem; backdrop-filter: blur(4px); -webkit-backdrop-filter: blur(4px); } .heading-share-modal[hidden] { display: none !important; } .hsm-dialog { max-width: 420px; width: 100%; background: var(--bs-body-bg, #fff); color: var(--bs-body-color, #212529); border: 1px solid var(--bs-border-color, rgba(0,0,0,0.1)); border-radius: 1rem; box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25); overflow: hidden; animation: hsm-fade-in 0.2s ease-out; } @keyframes hsm-fade-in { from { opacity: 0; transform: scale(0.95); } to { opacity: 1; transform: scale(1); } } [data-bs-theme="dark"] .hsm-dialog { background: #1e293b; border-color: rgba(255,255,255,0.1); color: #f8f9fa; } .hsm-header { display: flex; justify-content: space-between; align-items: center; padding: 1rem 1.5rem; border-bottom: 1px solid var(--bs-border-color, rgba(0,0,0,0.1)); background: rgba(0,0,0,0.02); } [data-bs-theme="dark"] .hsm-header { background: rgba(255,255,255,0.02); border-color: rgba(255,255,255,0.1); } .hsm-close { background: transparent; border: none; color: inherit; opacity: 0.5; padding: 0.25rem 0.5rem; border-radius: 0.25rem; font-size: 1.2rem; line-height: 1; transition: opacity 0.2s; } .hsm-close:hover { opacity: 1; } .hsm-body { padding: 1.5rem; } .hsm-url-group { display: flex !important; align-items: stretch; } .hsm-url-group .form-control { flex: 1; min-width: 0; margin: 0; background: var(--bs-secondary-bg, #f8f9fa); border-color: var(--bs-border-color, #dee2e6); border-top-right-radius: 0; border-bottom-right-radius: 0; height: 42px; } .hsm-url-group .btn { flex: 0 0 auto; margin: 0; margin-left: -1px; border-top-left-radius: 0; border-bottom-left-radius: 0; height: 42px; display: flex; align-items: center; justify-content: center; padding: 0 1.25rem; z-index: 2; } [data-bs-theme="dark"] .hsm-url-group .form-control { background: #0f172a; border-color: #334155; color: #e2e8f0; } .hsm-share-grid { display: flex; flex-direction: column; gap: 0.5rem; } .hsm-share-grid .btn { display: flex; align-items: center; justify-content: center; font-size: 0.9rem; padding: 0.6rem; border-color: var(--bs-border-color); width: 100%; } [data-bs-theme="dark"] .hsm-share-grid .btn { color: #e2e8f0; border-color: #475569; } [data-bs-theme="dark"] .hsm-share-grid .btn:hover { background: #334155; border-color: #cbd5e1; } </style> <script> (function(){ const modal = document.getElementById('headingShareModal'); if(!modal) return; const input = modal.querySelector('#headingShareInput'); const copyBtn = modal.querySelector('.hsm-copy'); const twitter = modal.querySelector('#share-twitter'); const linkedin = modal.querySelector('#share-linkedin'); const facebook = modal.querySelector('#share-facebook'); const closeBtn = modal.querySelector('.hsm-close'); let lastFocus=null; let trapBound=false; function buildUrl(id){ return window.location.origin + window.location.pathname + '#' + id; } function isOpen(){ return !modal.hasAttribute('hidden'); } function hydrate(id){ const url=buildUrl(id); input.value=url; const enc=encodeURIComponent(url); const text=encodeURIComponent(document.title); if(twitter) twitter.href=`https://twitter.com/intent/tweet?url=${enc}&text=${text}`; if(linkedin) linkedin.href=`https://www.linkedin.com/sharing/share-offsite/?url=${enc}`; if(facebook) facebook.href=`https://www.facebook.com/sharer/sharer.php?u=${enc}`; } function openModal(id){ lastFocus=document.activeElement; hydrate(id); if(!isOpen()){ modal.removeAttribute('hidden'); } requestAnimationFrame(()=>{ input.focus(); }); trapFocus(); } function closeModal(){ if(!isOpen()) return; modal.setAttribute('hidden',''); if(lastFocus && typeof lastFocus.focus==='function') lastFocus.focus(); } function copyCurrent(){ try{ navigator.clipboard.writeText(input.value).then(()=>feedback(true),()=>fallback()); } catch(e){ fallback(); } } function fallback(){ input.select(); try{ document.execCommand('copy'); feedback(true);}catch(e){ feedback(false);} } function feedback(ok){ if(!copyBtn) return; const icon=copyBtn.querySelector('i'); if(!icon) return; const prev=copyBtn.getAttribute('data-prev')||icon.className; if(!copyBtn.getAttribute('data-prev')) copyBtn.setAttribute('data-prev',prev); icon.className= ok ? 'fa-duotone fa-clipboard-check':'fa-duotone fa-circle-exclamation'; setTimeout(()=>{ icon.className=prev; },1800); } function handleShareClick(e){ e.preventDefault(); const btn=e.currentTarget; const id=btn.getAttribute('data-share-target'); if(id) openModal(id); } function bindShareButtons(){ document.querySelectorAll('.h-share').forEach(btn=>{ if(!btn.dataset.hShareBound){ btn.addEventListener('click', handleShareClick); btn.dataset.hShareBound='1'; } }); } bindShareButtons(); if(document.readyState==='loading'){ document.addEventListener('DOMContentLoaded', bindShareButtons); } else { requestAnimationFrame(bindShareButtons); } document.addEventListener('click', function(e){ const shareBtn=e.target.closest && e.target.closest('.h-share'); if(shareBtn && !shareBtn.dataset.hShareBound){ handleShareClick.call(shareBtn, e); } }, true); document.addEventListener('click', e=>{ if(e.target===modal) closeModal(); if(e.target.closest && e.target.closest('.hsm-close')){ e.preventDefault(); closeModal(); } if(copyBtn && (e.target===copyBtn || (e.target.closest && e.target.closest('.hsm-copy')))) { e.preventDefault(); copyCurrent(); } }); document.addEventListener('keydown', e=>{ if(e.key==='Escape' && isOpen()) closeModal(); }); function trapFocus(){ if(trapBound) return; trapBound=true; modal.addEventListener('keydown', f=>{ if(f.key==='Tab' && isOpen()){ const focusable=[...modal.querySelectorAll('a[href],button,input,textarea,select,[tabindex]:not([tabindex="-1"])')].filter(el=>!el.hasAttribute('disabled')); if(!focusable.length) return; const first=focusable[0]; const last=focusable[focusable.length-1]; if(f.shiftKey && document.activeElement===first){ f.preventDefault(); last.focus(); } else if(!f.shiftKey && document.activeElement===last){ f.preventDefault(); first.focus(); } } }); } if(closeBtn) closeBtn.addEventListener('click', e=>{ e.preventDefault(); closeModal(); }); })(); </script>Geode uses semantic versioning (SemVer) to communicate the nature and impact of changes across releases. <h4 id="semantic-versioning-schema" class="position-relative d-flex align-items-center group"> Semantic Versioning Schema <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="semantic-versioning-schema" aria-haspopup="dialog" aria-label="Share link: Semantic Versioning Schema"> Share link </button> </h4>Geode version numbers follow the format <code>MAJOR.MINOR.PATCH</code>: <ul> <li>MAJOR (e.g., 1.0.0 → 2.0.0): Breaking changes requiring migration</li> <li>MINOR (e.g., 0.2.15 → 0.3.0): New features, backward compatible</li> <li>PATCH (e.g., 0.2.14 → 0.2.15): Bug fixes, security patches</li> </ul> Current Version: v0.2.18 (Current stable release, March 30, 2026) <h4 id="release-types" class="position-relative d-flex align-items-center group"> Release Types <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="release-types" aria-haspopup="dialog" aria-label="Share link: Release Types"> Share link </button> </h4>Production Releases <ul> <li>Full feature set with comprehensive testing</li> <li>97.4% test coverage (1644/1688 tests passing)</li> <li>100% GQL compliance (see conformance profile)</li> <li>Suitable for enterprise production environments</li> </ul> Release Candidates (RC) <ul> <li>Feature-complete pre-release versions</li> <li>Beta testing phase for community validation</li> <li>Typically released 2-4 weeks before production release</li> </ul> Patch Releases <ul> <li>Critical bug fixes and security updates</li> <li>Released as needed, typically within 1-2 weeks of issue discovery</li> <li>Minimal risk, recommended for immediate deployment</li> </ul> <h4 id="release-frequency" class="position-relative d-flex align-items-center group"> Release Frequency <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="release-frequency" aria-haspopup="dialog" aria-label="Share link: Release Frequency"> Share link </button> </h4><ul> <li>Minor releases: Quarterly (approximately every 3 months)</li> <li>Patch releases: As needed for critical issues</li> <li>Major releases: Annually or when significant architectural changes are introduced</li> </ul> <h3 id="checking-current-version" class="position-relative d-flex align-items-center group"> Checking Current Version <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="checking-current-version" aria-haspopup="dialog" aria-label="Share link: Checking Current Version"> Share link </button> </h3>Verify your installed Geode version using the CLI: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">./geode --version # Output: Geode v0.2.18 (2026-03-30) # Check detailed build information ./geode version --verbose # Output: # Geode Graph Database # Version: 0.2.18 # Build Date: 2026-03-30 # Git Commit: <release-sha> # GQL Standard: ISO/IEC 39075:2024 # Zig Version: 0.1.0 </code></pre></div>Check version from client libraries: Go: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go">import "geodedb.com/geode" version := geode.Version() fmt.Printf("Client version: %s\n", version) </code></pre></div>Python: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python">import geode_client print(f"Client version: {geode_client.__version__}") </code></pre></div>Rust: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-rust" data-lang="rust">use geode_client; println!("Client version: {}", geode_client::VERSION); </code></pre></div> <h3 id="update-strategies" class="position-relative d-flex align-items-center group"> Update Strategies <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="update-strategies" aria-haspopup="dialog" aria-label="Share link: Update Strategies"> Share link </button> </h3>Choose an update strategy that balances risk mitigation with access to new capabilities. <h4 id="conservative-strategy" class="position-relative d-flex align-items-center group"> Conservative Strategy <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="conservative-strategy" aria-haspopup="dialog" aria-label="Share link: Conservative Strategy"> Share link </button> </h4>Recommended for critical production environments: <ol> <li>Wait 2-4 weeks after minor release announcement</li> <li>Review release notes and breaking changes</li> <li>Test in staging environment</li> <li>Monitor community feedback</li> <li>Deploy to production during maintenance window</li> </ol> Advantages: <ul> <li>Minimizes exposure to undiscovered issues</li> <li>Community identifies edge cases first</li> <li>More time for internal testing</li> </ul> Update frequency: Quarterly for minor releases, immediate for critical patches <h4 id="balanced-strategy" class="position-relative d-flex align-items-center group"> Balanced Strategy <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="balanced-strategy" aria-haspopup="dialog" aria-label="Share link: Balanced Strategy"> Share link </button> </h4>Recommended for most production environments: <ol> <li>Update to patch releases within 1 week</li> <li>Update to minor releases within 2 weeks</li> <li>Test in staging before production deployment</li> <li>Follow documented upgrade procedures</li> </ol> Advantages: <ul> <li>Access to new features relatively quickly</li> <li>Reduced accumulation of technical debt</li> <li>Security patches applied promptly</li> </ul> Update frequency: Monthly review cycle with selective updates <h4 id="aggressive-strategy" class="position-relative d-flex align-items-center group"> Aggressive Strategy <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="aggressive-strategy" aria-haspopup="dialog" aria-label="Share link: Aggressive Strategy"> Share link </button> </h4>Recommended for development environments and early adopters: <ol> <li>Update to latest release within days</li> <li>Participate in release candidate testing</li> <li>Provide community feedback</li> <li>Accept higher risk for access to cutting-edge features</li> </ol> Advantages: <ul> <li>Immediate access to new capabilities</li> <li>Contribute to community testing</li> <li>Influence future development</li> </ul> Update frequency: Continuous updates as releases become available <h3 id="upgrade-procedures" class="position-relative d-flex align-items-center group"> Upgrade Procedures <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="upgrade-procedures" aria-haspopup="dialog" aria-label="Share link: Upgrade Procedures"> Share link </button> </h3>Geode supports both in-place upgrades and blue-green deployment strategies. <h4 id="in-place-upgrade" class="position-relative d-flex align-items-center group"> In-Place Upgrade <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="in-place-upgrade" aria-haspopup="dialog" aria-label="Share link: In-Place Upgrade"> Share link </button> </h4>For single-instance deployments or small clusters: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># 1. Backup current database ./geode backup --output /backup/geode-$(date +%Y%m%d).db # 2. Stop Geode server gracefully ./geode shutdown --wait # 3. Replace binary mv geode geode.old wget https://geodedb.com/releases/geode-v0.2.18-linux-amd64 mv geode-v0.2.18-linux-amd64 geode chmod +x geode # 4. Run migration (if needed) ./geode migrate --check ./geode migrate --apply # 5. Start server ./geode serve --listen 0.0.0.0:3141 # 6. Verify version ./geode --version </code></pre></div> <h4 id="blue-green-deployment" class="position-relative d-flex align-items-center group"> Blue-Green Deployment <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="blue-green-deployment" aria-haspopup="dialog" aria-label="Share link: Blue-Green Deployment"> Share link </button> </h4>For high-availability clusters with zero downtime: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># 1. Deploy new version to green environment docker run -d --name geode-green \ -v /data/geode:/data \ -p 3142:3141 \ geodedb/geode:0.2.18 # 2. Verify green environment health curl http://localhost:3142/health # {"status": "healthy", "version": "0.2.18"} # 3. Run smoke tests against green ./test-harness --target localhost:3142 --suite smoke # 4. Switch traffic from blue to green (load balancer) # Update load balancer configuration # 5. Monitor green environment # Watch logs, metrics, error rates # 6. Decommission blue after stability confirmed docker stop geode-blue docker rm geode-blue </code></pre></div> <h4 id="rolling-upgrade-for-clusters" class="position-relative d-flex align-items-center group"> Rolling Upgrade for Clusters <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="rolling-upgrade-for-clusters" aria-haspopup="dialog" aria-label="Share link: Rolling Upgrade for Clusters"> Share link </button> </h4>For distributed deployments maintaining quorum: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Upgrade one node at a time for node in node1 node2 node3; do # Drain node ssh $node "./geode admin drain --wait" # Stop node ssh $node "systemctl stop geode" # Replace binary scp geode-v0.2.18 $node:/usr/local/bin/geode # Migrate (if needed) ssh $node "./geode migrate --apply" # Start node ssh $node "systemctl start geode" # Wait for node to rejoin cluster ssh $node "./geode admin wait-ready --timeout 120s" # Verify version ssh $node "./geode --version" # Proceed to next node done </code></pre></div> <h3 id="database-migrations" class="position-relative d-flex align-items-center group"> Database Migrations <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="database-migrations" aria-haspopup="dialog" aria-label="Share link: Database Migrations"> Share link </button> </h3>Geode handles schema migrations automatically for most updates. <h4 id="migration-process" class="position-relative d-flex align-items-center group"> Migration Process <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="migration-process" aria-haspopup="dialog" aria-label="Share link: Migration Process"> Share link </button> </h4>Check if migration is required: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">./geode migrate --check # Output: # Migration required: YES # Current schema version: 17 # Target schema version: 18 # Estimated duration: ~30 seconds # Backup recommended: YES </code></pre></div>Preview migration steps: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">./geode migrate --dry-run # Output: # Migration plan for v0.2.14 → v0.2.15: # 1. Validate graph metadata and name-to-UUID mappings # 2. Rebuild storage free-space bookkeeping if required # 3. Refresh query and catalog statistics # 4. Re-open graph stores and verify restart behavior # No data loss expected </code></pre></div>Apply migration: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">./geode migrate --apply # Output: # [1/4] Adding vector_embeddings table... done (2s) # [2/4] Creating property index... done (15s) # [3/4] Updating statistics... done (5s) # [4/4] Rebuilding label indexes... done (8s) # Migration completed successfully in 30s </code></pre></div> <h4 id="rollback-capability" class="position-relative d-flex align-items-center group"> Rollback Capability <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="rollback-capability" aria-haspopup="dialog" aria-label="Share link: Rollback Capability"> Share link </button> </h4>Geode supports rollback for most migrations: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Check if rollback is available ./geode migrate --rollback --check # Output: Rollback available: YES (safe) # Execute rollback ./geode migrate --rollback # Output: Rolled back to schema version 17 </code></pre></div>Note: Some migrations involving data transformations may not support rollback. Always backup before migrating. <h3 id="compatibility-matrix" class="position-relative d-flex align-items-center group"> Compatibility Matrix <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="compatibility-matrix" aria-haspopup="dialog" aria-label="Share link: Compatibility Matrix"> Share link </button> </h3>Understand compatibility between server and client library versions. <h4 id="server-client-compatibility" class="position-relative d-flex align-items-center group"> Server-Client Compatibility <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="server-client-compatibility" aria-haspopup="dialog" aria-label="Share link: Server-Client Compatibility"> Share link </button> </h4><table> <thead> <tr> <th>Server Version</th> <th>Go Client</th> <th>Python Client</th> <th>Rust Client</th> <th>Zig Client</th> </tr> </thead> <tbody> <tr> <td>v0.2.15</td> <td>rolling</td> <td>0.3.19</td> <td>0.1.1-alpha.8</td> <td>0.1.0</td> </tr> <tr> <td>v0.1.28-v0.1.39</td> <td>rolling</td> <td>0.3.19+</td> <td>0.1.1-alpha.8+</td> <td>0.1.0+</td> </tr> <tr> <td>v0.1.3-v0.1.27</td> <td>validate in staging</td> <td>0.3.x</td> <td>0.1.x</td> <td>0.1.x</td> </tr> </tbody> </table> General Rule: Match minor versions between server and clients for guaranteed compatibility. <h4 id="protocol-compatibility" class="position-relative d-flex align-items-center group"> Protocol Compatibility <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="protocol-compatibility" aria-haspopup="dialog" aria-label="Share link: Protocol Compatibility"> Share link </button> </h4>Geode’s Protobuf wire protocol maintains backward compatibility within major versions: <ul> <li>Wire Protocol: v1.x compatible across all v0.x releases</li> <li>QUIC/TLS: TLS 1.3 required (consistent across versions)</li> <li>Message Types: Additive only (new types added, old types maintained)</li> </ul> <h4 id="gql-standard-compliance" class="position-relative d-flex align-items-center group"> GQL Standard Compliance <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="gql-standard-compliance" aria-haspopup="dialog" aria-label="Share link: GQL Standard Compliance"> Share link </button> </h4>Geode tracks GQL standard evolution: <ul> <li>v0.2.15: Stable 100% ISO/IEC 39075:2024 compliance with CTE and DOT fixes</li> <li>v0.2.14: CTE execution and DOT support landed in the release train</li> <li>v0.2.12-v0.2.13: security hardening, per-graph storage, and QUIC stream multiplexing</li> </ul> Queries written for v0.1.1+ remain valid in newer versions unless they rely on deprecated features. <h3 id="release-notes-and-changelogs" class="position-relative d-flex align-items-center group"> Release Notes and Changelogs <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="release-notes-and-changelogs" aria-haspopup="dialog" aria-label="Share link: Release Notes and Changelogs"> Share link </button> </h3>Each release includes comprehensive documentation of changes. <h4 id="release-notes-contents" class="position-relative d-flex align-items-center group"> Release Notes Contents <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="release-notes-contents" aria-haspopup="dialog" aria-label="Share link: Release Notes Contents"> Share link </button> </h4>Release notes for each version include: <ol> <li>Breaking Changes: Required migration steps, deprecated feature removal</li> <li>New Features: Major capabilities, API additions</li> <li>Enhancements: Performance improvements, usability updates</li> <li>Bug Fixes: Issues resolved with reference numbers</li> <li>Security Updates: CVEs addressed, security improvements</li> <li>Deprecations: Features marked for future removal with migration guidance</li> </ol> <h4 id="example-release-note-v0215" class="position-relative d-flex align-items-center group"> Example Release Note (v0.2.15) <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="example-release-note-v0215" aria-haspopup="dialog" aria-label="Share link: Example Release Note (v0.2.15)"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown">## Geode v0.2.15 - March 2026 ### Breaking Changes - None ### New Features - CTE execution in the stable release line - DOT graph output fixes - 32-bit ARM UUIDv7 fix - Current release-line docs and upgrade guidance ### Enhancements - QUIC stream multiplexing for better concurrency - Poll-loop tuning for accepted-connection handling - Storage fixes for graph metadata and adapter label dictionaries - Release process now distinguishes stable `v0.2.15` from unreleased `main` fixes ### Bug Fixes - Fixed 32-bit ARM UUIDv7 generation - Corrected DOT output regressions carried through the March release train - Stabilized graph-storage restart behavior in post-tag `main` work ### Security Updates - Continued QUIC library maintenance and accepted-connection handling updates - Documentation now reflects current auth, API key, and mTLS support ### Deprecations - None in the tagged `v0.2.18` release; see unreleased `main` notes for open follow-up work </code></pre></div> <h4 id="accessing-release-notes" class="position-relative d-flex align-items-center group"> Accessing Release Notes <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="accessing-release-notes" aria-haspopup="dialog" aria-label="Share link: Accessing Release Notes"> Share link </button> </h4>Release notes are available through multiple channels: <ul> <li>Website: <a href="https://geodedb.com/releases/" >https://geodedb.com/releases/</a> </li> <li>GitHub: <a href="https://github.com/geodedb/geode/releases" aria-label="https://github.com/geodedb/geode/releases – opens in new window" target="_blank" rel="noopener noreferrer" >https://github.com/geodedb/geode/releases ↗ </a> </li> <li>CLI: <code>./geode release-notes --version 0.2.18</code></li> <li>API: <code>curl https://geodedb.com/api/v1/releases/0.2.18</code></li> </ul> <h3 id="update-notifications" class="position-relative d-flex align-items-center group"> Update Notifications <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="update-notifications" aria-haspopup="dialog" aria-label="Share link: Update Notifications"> Share link </button> </h3>Stay informed about new releases through multiple channels. <h4 id="rss-feed" class="position-relative d-flex align-items-center group"> RSS Feed <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="rss-feed" aria-haspopup="dialog" aria-label="Share link: RSS Feed"> Share link </button> </h4>Subscribe to release announcements: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">https://geodedb.com/releases/feed.xml </code></pre></div> <h4 id="email-notifications" class="position-relative d-flex align-items-center group"> Email Notifications <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="email-notifications" aria-haspopup="dialog" aria-label="Share link: Email Notifications"> Share link </button> </h4>Register for email alerts: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">curl -X POST https://geodedb.com/api/v1/notify/subscribe \ -H "Content-Type: application/json" \ -d '{"email": "[email protected]", "topics": ["releases", "security"]}' </code></pre></div> <h4 id="automated-update-checking" class="position-relative d-flex align-items-center group"> Automated Update Checking <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="automated-update-checking" aria-haspopup="dialog" aria-label="Share link: Automated Update Checking"> Share link </button> </h4>Configure Geode to check for updates: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Enable update checking ./geode config set update_check.enabled true ./geode config set update_check.frequency daily # Check for updates manually ./geode check-update # Output: # Current version: v0.2.14 # Latest version: v0.2.18 # Update available: YES # Release notes: https://gitlab.com/devnw/codepros/geode/geode/-/releases/v0.2.18 </code></pre></div> <h4 id="security-advisories" class="position-relative d-flex align-items-center group"> Security Advisories <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="security-advisories" aria-haspopup="dialog" aria-label="Share link: Security Advisories"> Share link </button> </h4>Critical security updates are announced via: <ul> <li>Security mailing list (<a href="mailto:[email protected]" >[email protected]</a> )</li> <li>GitHub Security Advisories</li> <li>CVE database entries</li> <li>In-product security alerts</li> </ul> <h3 id="testing-updates" class="position-relative d-flex align-items-center group"> Testing Updates <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="testing-updates" aria-haspopup="dialog" aria-label="Share link: Testing Updates"> Share link </button> </h3>Validate updates thoroughly before production deployment. <h4 id="staging-environment-testing" class="position-relative d-flex align-items-center group"> Staging Environment Testing <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="staging-environment-testing" aria-haspopup="dialog" aria-label="Share link: Staging Environment Testing"> Share link </button> </h4>Create a staging environment mirroring production: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Clone production data to staging ./geode backup --output /backup/prod.db ./geode restore --input /backup/prod.db --target staging:3141 # Deploy new version to staging ssh staging "docker pull geodedb/geode:0.2.18" ssh staging "docker-compose up -d" # Run test suite ./test-harness --target staging:3141 --suite full </code></pre></div> <h4 id="regression-testing" class="position-relative d-flex align-items-center group"> Regression Testing <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="regression-testing" aria-haspopup="dialog" aria-label="Share link: Regression Testing"> Share link </button> </h4>Automated regression test suite: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">cd geode-test-harness # Run comprehensive test suite make test-all-html # Check specific regression tests pytest tests/regression/ -v --html=report.html </code></pre></div> <h4 id="performance-testing" class="position-relative d-flex align-items-center group"> Performance Testing <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="performance-testing" aria-haspopup="dialog" aria-label="Share link: Performance Testing"> Share link </button> </h4>Benchmark performance before and after updates: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Baseline before update ./geode benchmark --suite standard --output baseline.json # After update ./geode benchmark --suite standard --output updated.json # Compare results ./geode benchmark --compare baseline.json updated.json # Output: # Query performance: +12% faster # Memory usage: -8% reduction # Throughput: +15% increase </code></pre></div> <h3 id="client-library-updates" class="position-relative d-flex align-items-center group"> Client Library Updates <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="client-library-updates" aria-haspopup="dialog" aria-label="Share link: Client Library Updates"> Share link </button> </h3>Keep client libraries synchronized with server versions. <h4 id="updating-go-client" class="position-relative d-flex align-items-center group"> Updating Go Client <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="updating-go-client" aria-haspopup="dialog" aria-label="Share link: Updating Go Client"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Update to specific version go get geodedb.com/[email protected] # Update to latest go get -u geodedb.com/geode # Verify version go list -m geodedb.com/geode </code></pre></div> <h4 id="updating-python-client" class="position-relative d-flex align-items-center group"> Updating Python Client <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="updating-python-client" aria-haspopup="dialog" aria-label="Share link: Updating Python Client"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Update to specific version pip install geode-client==0.3.19 # Update to latest pip install --upgrade geode-client # Verify version pip show geode-client </code></pre></div> <h4 id="updating-rust-client" class="position-relative d-flex align-items-center group"> Updating Rust Client <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="updating-rust-client" aria-haspopup="dialog" aria-label="Share link: Updating Rust Client"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Update Cargo.toml [dependencies] geode-client = "0.1.1-alpha.8" # Update dependencies cargo update # Verify version cargo tree | grep geode-client </code></pre></div> <h4 id="updating-zig-client" class="position-relative d-flex align-items-center group"> Updating Zig Client <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="updating-zig-client" aria-haspopup="dialog" aria-label="Share link: Updating Zig Client"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Update build.zig.zon .dependencies.geode_client.url = "https://geodedb.com/zig/geode-client-0.1.0.tar.gz" # Fetch updated dependency zig build --fetch # Verify version zig build version </code></pre></div> <h3 id="best-practices-for-updates" class="position-relative d-flex align-items-center group"> Best Practices for Updates <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="best-practices-for-updates" aria-haspopup="dialog" aria-label="Share link: Best Practices for Updates"> Share link </button> </h3> <h4 id="always-backup-before-updating" class="position-relative d-flex align-items-center group"> Always Backup Before Updating <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="always-backup-before-updating" aria-haspopup="dialog" aria-label="Share link: Always Backup Before Updating"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Create timestamped backup ./geode backup --output /backup/geode-$(date +%Y%m%d-%H%M%S).db # Verify backup integrity ./geode backup --verify /backup/geode-20260124-143000.db </code></pre></div> <h4 id="review-breaking-changes" class="position-relative d-flex align-items-center group"> Review Breaking Changes <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="review-breaking-changes" aria-haspopup="dialog" aria-label="Share link: Review Breaking Changes"> Share link </button> </h4>Read release notes carefully, focusing on breaking changes section: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Display breaking changes only ./geode release-notes --version 0.2.18 --filter breaking </code></pre></div> <h4 id="test-in-non-production-first" class="position-relative d-flex align-items-center group"> Test in Non-Production First <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="test-in-non-production-first" aria-haspopup="dialog" aria-label="Share link: Test in Non-Production First"> Share link </button> </h4>Never update production directly: <ol> <li>Test in development environment</li> <li>Validate in staging environment</li> <li>Deploy to production during maintenance window</li> </ol> <h4 id="monitor-after-updates" class="position-relative d-flex align-items-center group"> Monitor After Updates <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="monitor-after-updates" aria-haspopup="dialog" aria-label="Share link: Monitor After Updates"> Share link </button> </h4>Increase monitoring for 24-48 hours after updates: <ul> <li>Query performance metrics</li> <li>Error rates and types</li> <li>Memory and CPU utilization</li> <li>Connection pool statistics</li> <li>Transaction success rates</li> </ul> <h4 id="document-update-process" class="position-relative d-flex align-items-center group"> Document Update Process <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="document-update-process" aria-haspopup="dialog" aria-label="Share link: Document Update Process"> Share link </button> </h4>Maintain runbook for updates: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown">## Geode Update Runbook ### Pre-Update Checklist - [ ] Review release notes - [ ] Create backup - [ ] Notify team of maintenance window - [ ] Prepare rollback plan ### Update Steps 1. Stop application traffic 2. Backup database 3. Deploy new version 4. Run migrations 5. Verify health checks 6. Resume traffic 7. Monitor metrics ### Rollback Steps 1. Stop new version 2. Restore from backup 3. Start previous version 4. Verify functionality </code></pre></div> <h3 id="deprecation-policy" class="position-relative d-flex align-items-center group"> Deprecation Policy <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="deprecation-policy" aria-haspopup="dialog" aria-label="Share link: Deprecation Policy"> Share link </button> </h3>Geode follows a clear deprecation timeline to maintain stability while evolving features. <h4 id="deprecation-process" class="position-relative d-flex align-items-center group"> Deprecation Process <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="deprecation-process" aria-haspopup="dialog" aria-label="Share link: Deprecation Process"> Share link </button> </h4><ol> <li>Announcement: Feature marked as deprecated in release notes</li> <li>Warning Period: Feature remains functional but logs warnings (2+ minor versions)</li> <li>Removal: Feature removed in major version increment</li> </ol> <h4 id="migration-support" class="position-relative d-flex align-items-center group"> Migration Support <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="migration-support" aria-haspopup="dialog" aria-label="Share link: Migration Support"> Share link </button> </h4>Deprecated features include migration guidance: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Check for deprecated feature usage ./geode audit --check-deprecated # Output: # WARNING: Using deprecated transaction API # Affected queries: 12 # Migration guide: https://geodedb.com/migration/transaction-api # Removal planned: v0.2.0 </code></pre></div> <h3 id="community-and-support" class="position-relative d-flex align-items-center group"> Community and Support <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="community-and-support" aria-haspopup="dialog" aria-label="Share link: Community and Support"> Share link </button> </h3>Engage with the Geode community for update assistance. <h4 id="update-assistance-channels" class="position-relative d-flex align-items-center group"> Update Assistance Channels <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="update-assistance-channels" aria-haspopup="dialog" aria-label="Share link: Update Assistance Channels"> Share link </button> </h4><ul> <li>Documentation: /docs/releases/</li> <li>Community Forum: <a href="https://community.geodedb.com" aria-label="https://community.geodedb.com – opens in new window" target="_blank" rel="noopener noreferrer" >https://community.geodedb.com ↗ </a> </li> <li>GitHub Issues: <a href="https://github.com/geodedb/geode/issues" aria-label="https://github.com/geodedb/geode/issues – opens in new window" target="_blank" rel="noopener noreferrer" >https://github.com/geodedb/geode/issues ↗ </a> </li> <li>Discord: <a href="https://discord.gg/geodedb" aria-label="https://discord.gg/geodedb – opens in new window" target="_blank" rel="noopener noreferrer" >https://discord.gg/geodedb ↗ </a> </li> <li>Enterprise Support: <a href="mailto:[email protected]" >[email protected]</a> </li> </ul> <h4 id="contributing-to-updates" class="position-relative d-flex align-items-center group"> Contributing to Updates <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="contributing-to-updates" aria-haspopup="dialog" aria-label="Share link: Contributing to Updates"> Share link </button> </h4>Participate in the development process: <ul> <li>Test release candidates and provide feedback</li> <li>Report bugs discovered in new versions</li> <li>Suggest features for future releases</li> <li>Contribute pull requests for fixes and enhancements</li> </ul> Keeping Geode updated ensures your graph database deployment benefits from continuous improvements in performance, security, and functionality while maintaining compatibility with the evolving GQL standard.

Popular

Related Articles

Releases