Server Configuration Reference

<h3 id="overview" class="position-relative d-flex align-items-center group"> Overview <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="overview" aria-haspopup="dialog" aria-label="Share link: Overview"> 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>This guide provides complete reference documentation for configuring the Geode database server. Configuration can be provided through: <ol> <li>Command-line flags - Highest precedence</li> <li>Environment variables - Medium precedence</li> <li>YAML configuration file - Lowest precedence</li> </ol> Quick Links: <ul> <li><a href="https://geodedb.com/docs/configuration/server-configuration/#command-line-flags" >Command-Line Flags</a> </li> <li><a href="https://geodedb.com/docs/configuration/server-configuration/#environment-variables" >Environment Variables</a> </li> <li><a href="https://geodedb.com/docs/configuration/server-configuration/#yaml-configuration-file" >YAML Configuration</a> </li> <li><a href="https://geodedb.com/docs/configuration/server-configuration/#configuration-examples" >Configuration Examples</a> </li> <li><a href="https://geodedb.com/docs/configuration/server-configuration/#tls-certificate-setup" >TLS/Certificate Setup</a> </li> </ul> <hr> <h3 id="command-line-flags" class="position-relative d-flex align-items-center group"> Command-Line Flags <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="command-line-flags" aria-haspopup="dialog" aria-label="Share link: Command-Line Flags"> Share link </button> </h3> <h4 id="server-binary-geode-serve" class="position-relative d-flex align-items-center group"> Server Binary: <code>geode serve</code> <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-binary-geode-serve" aria-haspopup="dialog" aria-label="Share link: Server Binary: geode serve"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">geode serve [OPTIONS] </code></pre></div><table> <thead> <tr> <th>Flag</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>--listen</code></td> <td>string</td> <td><code>0.0.0.0:3141</code></td> <td>QUIC listen address and port</td> </tr> <tr> <td><code>--listen-quic</code></td> <td>string</td> <td><code>0.0.0.0:3141</code></td> <td>(Alias for <code>--listen</code>) QUIC bind address</td> </tr> <tr> <td><code>--data-dir</code></td> <td>path</td> <td><code>./data</code></td> <td>Data directory for storage files</td> </tr> <tr> <td><code>--tls-cert</code></td> <td>path</td> <td>(required)</td> <td>Path to TLS certificate file (PEM format)</td> </tr> <tr> <td><code>--tls-key</code></td> <td>path</td> <td>(required)</td> <td>Path to TLS private key file (PEM format)</td> </tr> <tr> <td><code>--log-level</code></td> <td>string</td> <td><code>info</code></td> <td>Log level: <code>error</code>, <code>warn</code>, <code>info</code>, <code>debug</code>, <code>trace</code></td> </tr> <tr> <td><code>--log-json</code></td> <td>flag</td> <td>false</td> <td>Output logs in JSON format</td> </tr> <tr> <td><code>--log-file</code></td> <td>path</td> <td>(stderr)</td> <td>Log file path (default: stderr)</td> </tr> <tr> <td><code>--enable-tde</code></td> <td>flag</td> <td>false</td> <td>Enable Transparent Data Encryption</td> </tr> <tr> <td><code>--max-connections</code></td> <td>int</td> <td><code>10000</code></td> <td>Maximum concurrent connections</td> </tr> <tr> <td><code>--page-cache-size</code></td> <td>int</td> <td><code>1024</code></td> <td>Page cache size in MB</td> </tr> <tr> <td><code>--wal-dir</code></td> <td>path</td> <td><code><data-dir>/wal</code></td> <td>Write-ahead log directory</td> </tr> <tr> <td><code>--config</code></td> <td>path</td> <td>-</td> <td>Path to YAML configuration file</td> </tr> </tbody> </table> <h4 id="examples" class="position-relative d-flex align-items-center group"> Examples <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="examples" aria-haspopup="dialog" aria-label="Share link: Examples"> Share link </button> </h4>Basic Server Start (Development): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Generate self-signed certificate first openssl req -x509 -newkey rsa:4096 \ -keyout server.key -out server.crt \ -days 365 -nodes -subj "/CN=localhost" # Start server geode serve \ --listen 0.0.0.0:3141 \ --tls-cert server.crt \ --tls-key server.key </code></pre></div>Production Server with all options: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">geode serve \ --listen 0.0.0.0:3141 \ --data-dir /var/lib/geode/data \ --wal-dir /var/lib/geode/wal \ --tls-cert /etc/geode/tls/server.crt \ --tls-key /etc/geode/tls/server.key \ --log-level info \ --log-json \ --log-file /var/log/geode/server.log \ --enable-tde \ --max-connections 50000 \ --page-cache-size 4096 </code></pre></div>Using Configuration File: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">geode serve --config /etc/geode/config.yaml </code></pre></div><hr> <h3 id="environment-variables" class="position-relative d-flex align-items-center group"> Environment Variables <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="environment-variables" aria-haspopup="dialog" aria-label="Share link: Environment Variables"> Share link </button> </h3> <h4 id="core-settings" class="position-relative d-flex align-items-center group"> Core Settings <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="core-settings" aria-haspopup="dialog" aria-label="Share link: Core Settings"> Share link </button> </h4><table> <thead> <tr> <th>Variable</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>GEODE_DATA_DIR</code></td> <td>path</td> <td><code>./data</code></td> <td>Data directory path</td> </tr> <tr> <td><code>GEODE_LOG_LEVEL</code></td> <td>string</td> <td><code>info</code></td> <td>Log level (error, warn, info, debug, trace)</td> </tr> <tr> <td><code>LOG_LEVEL</code></td> <td>string</td> <td><code>info</code></td> <td>(Alternative) Log level for Docker compatibility</td> </tr> <tr> <td><code>GEODE_LOG_FORMAT</code></td> <td>string</td> <td><code>text</code></td> <td>Log format: <code>text</code> or <code>json</code></td> </tr> <tr> <td><code>GEODE_LISTEN</code></td> <td>string</td> <td><code>0.0.0.0:3141</code></td> <td>QUIC listen address</td> </tr> <tr> <td><code>GEODE_TLS_CERT</code></td> <td>path</td> <td>-</td> <td>TLS certificate path</td> </tr> <tr> <td><code>GEODE_TLS_KEY</code></td> <td>path</td> <td>-</td> <td>TLS private key path</td> </tr> </tbody> </table> <h4 id="performance-tuning" class="position-relative d-flex align-items-center group"> Performance Tuning <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-tuning" aria-haspopup="dialog" aria-label="Share link: Performance Tuning"> Share link </button> </h4><table> <thead> <tr> <th>Variable</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>GEODE_MAX_CONNECTIONS</code></td> <td>int</td> <td><code>10000</code></td> <td>Maximum concurrent connections</td> </tr> <tr> <td><code>GEODE_PAGE_CACHE_SIZE</code></td> <td>int</td> <td><code>1024</code></td> <td>Page cache size in MB</td> </tr> <tr> <td><code>GEODE_QUERY_TIMEOUT</code></td> <td>int</td> <td><code>300</code></td> <td>Query timeout in seconds</td> </tr> <tr> <td><code>GEODE_TRANSACTION_TIMEOUT</code></td> <td>int</td> <td><code>300</code></td> <td>Transaction timeout in seconds</td> </tr> </tbody> </table> <h4 id="security--encryption" class="position-relative d-flex align-items-center group"> Security &amp; Encryption <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--encryption" aria-haspopup="dialog" aria-label="Share link: Security &amp; Encryption"> Share link </button> </h4><table> <thead> <tr> <th>Variable</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>GEODE_ENABLE_TDE</code></td> <td>bool</td> <td><code>false</code></td> <td>Enable Transparent Data Encryption</td> </tr> <tr> <td><code>GEODE_DISK_KEY_HEX</code></td> <td>string</td> <td>-</td> <td>TDE encryption key (64 hex characters)</td> </tr> <tr> <td><code>GEODE_KMS_PROVIDER</code></td> <td>string</td> <td><code>env</code></td> <td>KMS provider: <code>env</code>, <code>vault</code>, <code>aws</code></td> </tr> <tr> <td><code>VAULT_ADDR</code></td> <td>string</td> <td>-</td> <td>HashiCorp Vault address (if using Vault KMS)</td> </tr> <tr> <td><code>VAULT_TOKEN</code></td> <td>string</td> <td>-</td> <td>Vault authentication token</td> </tr> <tr> <td><code>AWS_KMS_KEY_ID</code></td> <td>string</td> <td>-</td> <td>AWS KMS key ID (if using AWS KMS)</td> </tr> </tbody> </table> <h4 id="query-optimization" class="position-relative d-flex align-items-center group"> Query Optimization <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="query-optimization" aria-haspopup="dialog" aria-label="Share link: Query Optimization"> Share link </button> </h4><table> <thead> <tr> <th>Variable</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>GEODE_TRACE_OPTIMIZER</code></td> <td>bool</td> <td><code>false</code></td> <td>Enable optimizer trace logging</td> </tr> <tr> <td><code>GEODE_ORDER_KEYS_EXPR</code></td> <td>bool</td> <td><code>false</code></td> <td>Allow ORDER BY expressions (not just properties)</td> </tr> <tr> <td><code>GEODE_TELEMETRY_PAGING</code></td> <td>bool</td> <td><code>false</code></td> <td>Enable paging telemetry</td> </tr> </tbody> </table> <h4 id="cloud-backup-s3" class="position-relative d-flex align-items-center group"> Cloud Backup (S3) <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="cloud-backup-s3" aria-haspopup="dialog" aria-label="Share link: Cloud Backup (S3)"> Share link </button> </h4><table> <thead> <tr> <th>Variable</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>AWS_ACCESS_KEY_ID</code></td> <td>string</td> <td>-</td> <td>AWS/S3 access key ID</td> </tr> <tr> <td><code>AWS_SECRET_ACCESS_KEY</code></td> <td>string</td> <td>-</td> <td>AWS/S3 secret access key</td> </tr> <tr> <td><code>AWS_REGION</code></td> <td>string</td> <td><code>us-east-1</code></td> <td>AWS region</td> </tr> <tr> <td><code>S3_ENDPOINT</code></td> <td>string</td> <td>-</td> <td>Custom S3 endpoint (e.g., MinIO, DigitalOcean Spaces)</td> </tr> <tr> <td><code>S3_BUCKET</code></td> <td>string</td> <td>-</td> <td>S3 bucket name for backups</td> </tr> </tbody> </table> <h4 id="change-data-capture-cdc" class="position-relative d-flex align-items-center group"> Change Data Capture (CDC) <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="change-data-capture-cdc" aria-haspopup="dialog" aria-label="Share link: Change Data Capture (CDC)"> Share link </button> </h4><table> <thead> <tr> <th>Variable</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>GEODE_CDC_ENABLE</code></td> <td>bool</td> <td><code>false</code></td> <td>Enable CDC</td> </tr> <tr> <td><code>CDC_KAFKA_BROKERS</code></td> <td>string</td> <td>-</td> <td>Kafka broker addresses (comma-separated)</td> </tr> <tr> <td><code>CDC_WEBHOOK_ENDPOINT</code></td> <td>string</td> <td>-</td> <td>HTTP webhook endpoint for CDC events</td> </tr> <tr> <td><code>WEBHOOK_TOKEN</code></td> <td>string</td> <td>-</td> <td>Authorization token for webhook</td> </tr> </tbody> </table> <h4 id="quic-transport" class="position-relative d-flex align-items-center group"> QUIC Transport <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="quic-transport" aria-haspopup="dialog" aria-label="Share link: QUIC Transport"> Share link </button> </h4><table> <thead> <tr> <th>Variable</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>GEODE_QUIC_FORCE_CLOSE</code></td> <td>bool</td> <td><code>false</code></td> <td>Force immediate connection close</td> </tr> <tr> <td><code>GEODE_QUIC_PASSIVE_TEARDOWN</code></td> <td>bool</td> <td><code>false</code></td> <td>Use passive connection teardown</td> </tr> </tbody> </table> <h4 id="developmenttesting" class="position-relative d-flex align-items-center group"> Development/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="developmenttesting" aria-haspopup="dialog" aria-label="Share link: Development/Testing"> Share link </button> </h4><table> <thead> <tr> <th>Variable</th> <th>Type</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>GEODE_CAPTURE_SERVER_STDERR</code></td> <td>bool</td> <td><code>false</code></td> <td>Capture server stderr (for testing)</td> </tr> <tr> <td><code>GEODE_INSECURE</code></td> <td>bool</td> <td><code>false</code></td> <td>Disable TLS verification (dev only!)</td> </tr> </tbody> </table> <hr> <h3 id="yaml-configuration-file" class="position-relative d-flex align-items-center group"> YAML Configuration File <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="yaml-configuration-file" aria-haspopup="dialog" aria-label="Share link: YAML Configuration File"> Share link </button> </h3> <h4 id="file-structure" class="position-relative d-flex align-items-center group"> File Structure <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="file-structure" aria-haspopup="dialog" aria-label="Share link: File Structure"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"># geode.yaml - Complete configuration example server: listen: '0.0.0.0:3141' data_dir: '/var/lib/geode/data' wal_dir: '/var/lib/geode/wal' max_connections: 10000 logging: level: 'info' # error, warn, info, debug, trace format: 'json' # text or json file: '/var/log/geode/server.log' tls: cert: '/etc/geode/tls/server.crt' key: '/etc/geode/tls/server.key' auto_generate: false # Auto-generate self-signed cert (dev only) storage: page_size: 8192 # Bytes per page (default: 8KB) cache_size: '4GB' # Page cache size (supports MB, GB suffixes) enable_tde: true # Transparent Data Encryption disk_key_hex: '<64-hex-chars>' # TDE encryption key performance: query_timeout: 300 # Seconds transaction_timeout: 300 # Seconds page_cache_size: 4096 # MB optimizer: trace: false # Enable optimizer trace logging small_n_threshold: 100 # Threshold for small-N optimization federation: enabled: true # Enable distributed query federation coordinator: true # This node is coordinator shards: - id: 'shard1' endpoint: 'node1.cluster:3141' - id: 'shard2' endpoint: 'node2.cluster:3141' - id: 'shard3' endpoint: 'node3.cluster:3141' backup: s3: bucket: 'geode-backups' prefix: 'prod' region: 'us-east-1' endpoint: '' # Custom endpoint (MinIO, DigitalOcean) retention_days: 30 access_key_id: '${AWS_ACCESS_KEY_ID}' # From environment secret_access_key: '${AWS_SECRET_ACCESS_KEY}' cdc: enabled: false webhooks: - name: 'primary' endpoint: 'https://api.example.com/webhook' headers: Authorization: 'Bearer ${WEBHOOK_TOKEN}' X-Tenant-ID: 'tenant-123' retry: max_attempts: 5 base_delay_ms: 100 max_delay_ms: 30000 dlq: enabled: true max_size: 10000 retention_hours: 168 idempotency: enabled: true header: 'X-Idempotency-Key' security: kms_provider: 'vault' # env, vault, aws vault: address: 'https://vault.example.com:8200' token: '${VAULT_TOKEN}' mount_path: 'geode-keys' aws_kms: key_id: 'arn:aws:kms:us-east-1:123456789012:key/...' region: 'us-east-1' monitoring: metrics: enabled: true listen: '0.0.0.0:9090' # Prometheus metrics endpoint health: enabled: true listen: '0.0.0.0:8080' # Health/readiness endpoints </code></pre></div> <h4 id="loading-configuration" class="position-relative d-flex align-items-center group"> Loading Configuration <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="loading-configuration" aria-haspopup="dialog" aria-label="Share link: Loading Configuration"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Load from file geode serve --config /etc/geode/config.yaml # Override with environment variables GEODE_LOG_LEVEL=debug geode serve --config /etc/geode/config.yaml # Override with command-line flags (highest precedence) geode serve \ --config /etc/geode/config.yaml \ --max-connections 20000 </code></pre></div><hr> <h3 id="configuration-examples" class="position-relative d-flex align-items-center group"> Configuration Examples <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="configuration-examples" aria-haspopup="dialog" aria-label="Share link: Configuration Examples"> Share link </button> </h3> <h4 id="development-configuration" class="position-relative d-flex align-items-center group"> Development Configuration <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="development-configuration" aria-haspopup="dialog" aria-label="Share link: Development Configuration"> Share link </button> </h4>File: <code>dev-config.yaml</code> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">server: listen: '127.0.0.1:3141' data_dir: './dev-data' logging: level: 'debug' format: 'text' tls: auto_generate: true # Auto-generate self-signed cert storage: cache_size: '512MB' performance: page_cache_size: 256 optimizer: trace: true # See optimizer decisions </code></pre></div>Start Command: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">geode serve --config dev-config.yaml </code></pre></div> <h4 id="staging-configuration" class="position-relative d-flex align-items-center group"> Staging Configuration <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-configuration" aria-haspopup="dialog" aria-label="Share link: Staging Configuration"> Share link </button> </h4>File: <code>/etc/geode/staging-config.yaml</code> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">server: listen: '0.0.0.0:3141' data_dir: '/var/lib/geode/staging/data' max_connections: 5000 logging: level: 'info' format: 'json' file: '/var/log/geode/staging.log' tls: cert: '/etc/geode/tls/staging.crt' key: '/etc/geode/tls/staging.key' storage: cache_size: '2GB' enable_tde: true performance: page_cache_size: 2048 backup: s3: bucket: 'geode-backups-staging' prefix: 'staging' retention_days: 7 monitoring: metrics: enabled: true listen: '0.0.0.0:9090' health: enabled: true listen: '0.0.0.0:8080' </code></pre></div> <h4 id="production-configuration" class="position-relative d-flex align-items-center group"> Production Configuration <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="production-configuration" aria-haspopup="dialog" aria-label="Share link: Production Configuration"> Share link </button> </h4>File: <code>/etc/geode/prod-config.yaml</code> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">server: listen: '0.0.0.0:3141' data_dir: '/var/lib/geode/data' wal_dir: '/var/lib/geode/wal' max_connections: 50000 logging: level: 'error' # Production: errors only format: 'json' file: '/var/log/geode/server.log' tls: cert: '/etc/letsencrypt/live/geode.example.com/fullchain.pem' key: '/etc/letsencrypt/live/geode.example.com/privkey.pem' storage: cache_size: '8GB' enable_tde: true # GEODE_DISK_KEY_HEX from environment (managed by secrets manager) performance: query_timeout: 300 transaction_timeout: 300 page_cache_size: 8192 federation: enabled: true coordinator: true shards: - id: 'shard1' endpoint: 'geode-node1.internal:3141' - id: 'shard2' endpoint: 'geode-node2.internal:3141' - id: 'shard3' endpoint: 'geode-node3.internal:3141' backup: s3: bucket: 'geode-backups-prod' prefix: 'prod' region: 'us-east-1' retention_days: 90 cdc: enabled: true webhooks: - name: 'analytics' endpoint: 'https://analytics.example.com/webhook' headers: Authorization: 'Bearer ${WEBHOOK_TOKEN}' retry: max_attempts: 5 base_delay_ms: 100 max_delay_ms: 30000 dlq: enabled: true max_size: 100000 retention_hours: 168 idempotency: enabled: true security: kms_provider: 'vault' vault: address: 'https://vault.prod.internal:8200' token: '${VAULT_TOKEN}' mount_path: 'geode-prod-keys' monitoring: metrics: enabled: true listen: '0.0.0.0:9090' health: enabled: true listen: '0.0.0.0:8080' </code></pre></div>Production Start (systemd): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># /etc/systemd/system/geode.service [Unit] Description=Geode Graph Database After=network.target vault.service [Service] Type=simple User=geode Group=geode WorkingDirectory=/var/lib/geode Environment="GEODE_DISK_KEY_HEX=<from-vault>" Environment="VAULT_TOKEN=<from-vault>" Environment="AWS_ACCESS_KEY_ID=<from-secrets>" Environment="AWS_SECRET_ACCESS_KEY=<from-secrets>" ExecStart=/usr/local/bin/geode serve --config /etc/geode/prod-config.yaml Restart=on-failure RestartSec=10 LimitNOFILE=65536 [Install] WantedBy=multi-user.target </code></pre></div> <h4 id="docker-configuration" class="position-relative d-flex align-items-center group"> Docker Configuration <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="docker-configuration" aria-haspopup="dialog" aria-label="Share link: Docker Configuration"> Share link </button> </h4>docker-compose.yml: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">version: '3.8' services: geode: image: geodedb/geode:latest ports: - "3141:3141/udp" # QUIC - "9090:9090" # Metrics - "8080:8080" # Health volumes: - geode-data:/var/lib/geode/data - geode-wal:/var/lib/geode/wal - ./config.yaml:/etc/geode/config.yaml:ro - ./tls:/etc/geode/tls:ro environment: LOG_LEVEL: ${LOG_LEVEL:-error} GEODE_DISK_KEY_HEX: ${GEODE_DISK_KEY_HEX} AWS_ACCESS_KEY_ID: ${AWS_ACCESS_KEY_ID} AWS_SECRET_ACCESS_KEY: ${AWS_SECRET_ACCESS_KEY} VAULT_TOKEN: ${VAULT_TOKEN} command: ["serve", "--config", "/etc/geode/config.yaml"] restart: unless-stopped ulimits: nofile: soft: 65536 hard: 65536 volumes: geode-data: geode-wal: </code></pre></div>Start with override: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Production (error logs only) docker-compose up -d # Debug mode LOG_LEVEL=debug docker-compose up # With secrets GEODE_DISK_KEY_HEX=$(vault kv get -field=key geode/tde) \ VAULT_TOKEN=$(vault print token) \ AWS_ACCESS_KEY_ID=$(vault kv get -field=access_key aws/geode) \ AWS_SECRET_ACCESS_KEY=$(vault kv get -field=secret_key aws/geode) \ docker-compose up -d </code></pre></div><hr> <h3 id="tls-certificate-setup" class="position-relative d-flex align-items-center group"> TLS Certificate Setup <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="tls-certificate-setup" aria-haspopup="dialog" aria-label="Share link: TLS Certificate Setup"> Share link </button> </h3> <h4 id="development-self-signed" class="position-relative d-flex align-items-center group"> Development (Self-Signed) <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="development-self-signed" aria-haspopup="dialog" aria-label="Share link: Development (Self-Signed)"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Generate self-signed certificate openssl req -x509 -newkey rsa:4096 \ -keyout server.key \ -out server.crt \ -days 365 \ -nodes \ -subj "/CN=localhost" # Start server geode serve \ --tls-cert server.crt \ --tls-key server.key </code></pre></div> <h4 id="production-lets-encrypt" class="position-relative d-flex align-items-center group"> Production (Let&rsquo;s Encrypt) <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="production-lets-encrypt" aria-haspopup="dialog" aria-label="Share link: Production (Lets Encrypt)"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Install certbot sudo apt-get install certbot # Get certificate (requires domain and port 80/443 access) sudo certbot certonly --standalone \ -d geode.example.com \ --agree-tos \ -m [email protected] # Certificates will be in: # /etc/letsencrypt/live/geode.example.com/fullchain.pem # /etc/letsencrypt/live/geode.example.com/privkey.pem # Start server sudo geode serve \ --tls-cert /etc/letsencrypt/live/geode.example.com/fullchain.pem \ --tls-key /etc/letsencrypt/live/geode.example.com/privkey.pem # Auto-renewal (add to crontab) 0 0 * * * certbot renew --quiet --post-hook "systemctl restart geode" </code></pre></div> <h4 id="production-custom-ca" class="position-relative d-flex align-items-center group"> Production (Custom CA) <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="production-custom-ca" aria-haspopup="dialog" aria-label="Share link: Production (Custom CA)"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># If using internal CA, provide full chain cat server.crt intermediate.crt root.crt > fullchain.pem # Start server geode serve \ --tls-cert fullchain.pem \ --tls-key server.key </code></pre></div> <h4 id="verify-certificate" class="position-relative d-flex align-items-center group"> Verify Certificate <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="verify-certificate" aria-haspopup="dialog" aria-label="Share link: Verify Certificate"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Check certificate details openssl x509 -in server.crt -text -noout # Verify certificate and key match openssl x509 -noout -modulus -in server.crt | openssl md5 openssl rsa -noout -modulus -in server.key | openssl md5 # MD5 hashes should match # Test TLS connection openssl s_client -connect localhost:3141 -showcerts </code></pre></div><hr> <h3 id="performance-tuning-1" class="position-relative d-flex align-items-center group"> Performance Tuning <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-tuning-1" aria-haspopup="dialog" aria-label="Share link: Performance Tuning"> Share link </button> </h3> <h4 id="memory-configuration" class="position-relative d-flex align-items-center group"> Memory Configuration <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="memory-configuration" aria-haspopup="dialog" aria-label="Share link: Memory Configuration"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"># For small deployments (<10GB data) storage: cache_size: '1GB' performance: page_cache_size: 1024 # For medium deployments (10-100GB data) storage: cache_size: '4GB' performance: page_cache_size: 4096 # For large deployments (>100GB data) storage: cache_size: '16GB' performance: page_cache_size: 16384 </code></pre></div> <h4 id="connection-tuning" class="position-relative d-flex align-items-center group"> Connection Tuning <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="connection-tuning" aria-haspopup="dialog" aria-label="Share link: Connection Tuning"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"># Low-concurrency workload server: max_connections: 100 # Medium-concurrency workload server: max_connections: 1000 # High-concurrency workload server: max_connections: 50000 </code></pre></div>System Limits: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Increase file descriptor limit ulimit -n 65536 # Or set in /etc/security/limits.conf geode soft nofile 65536 geode hard nofile 65536 </code></pre></div> <h4 id="query-timeouts" class="position-relative d-flex align-items-center group"> Query Timeouts <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="query-timeouts" aria-haspopup="dialog" aria-label="Share link: Query Timeouts"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"># Short-lived queries (OLTP) performance: query_timeout: 30 transaction_timeout: 60 # Mixed workload performance: query_timeout: 300 transaction_timeout: 300 # Analytics workload performance: query_timeout: 3600 transaction_timeout: 3600 </code></pre></div><hr> <h3 id="log-configuration" class="position-relative d-flex align-items-center group"> Log Configuration <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="log-configuration" aria-haspopup="dialog" aria-label="Share link: Log Configuration"> Share link </button> </h3> <h4 id="log-levels" class="position-relative d-flex align-items-center group"> Log Levels <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="log-levels" aria-haspopup="dialog" aria-label="Share link: Log Levels"> Share link </button> </h4><table> <thead> <tr> <th>Level</th> <th>Use Case</th> <th>Volume</th> </tr> </thead> <tbody> <tr> <td><code>error</code></td> <td>Production (default)</td> <td>Minimal - errors only</td> </tr> <tr> <td><code>warn</code></td> <td>Production (with warnings)</td> <td>Low - errors + warnings</td> </tr> <tr> <td><code>info</code></td> <td>Development/Staging</td> <td>Medium - general info</td> </tr> <tr> <td><code>debug</code></td> <td>Troubleshooting</td> <td>High - detailed debugging</td> </tr> <tr> <td><code>trace</code></td> <td>Deep troubleshooting</td> <td>Very High - all events</td> </tr> </tbody> </table> <h4 id="log-formats" class="position-relative d-flex align-items-center group"> Log Formats <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="log-formats" aria-haspopup="dialog" aria-label="Share link: Log Formats"> Share link </button> </h4>Text Format (human-readable): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">2026-01-23T10:30:45Z [INFO] Server started on 0.0.0.0:3141 2026-01-23T10:30:46Z [DEBUG] Accepted connection from 192.168.1.100:54321 2026-01-23T10:30:46Z [INFO] Query completed in 12ms </code></pre></div>JSON Format (machine-parsable): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json">{"timestamp":"2026-01-23T10:30:45Z","level":"INFO","message":"Server started on 0.0.0.0:3141"} {"timestamp":"2026-01-23T10:30:46Z","level":"DEBUG","message":"Accepted connection from 192.168.1.100:54321"} {"timestamp":"2026-01-23T10:30:46Z","level":"INFO","message":"Query completed in 12ms","duration_ms":12} </code></pre></div> <h4 id="log-rotation" class="position-relative d-flex align-items-center group"> Log Rotation <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="log-rotation" aria-haspopup="dialog" aria-label="Share link: Log Rotation"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Using logrotate # /etc/logrotate.d/geode /var/log/geode/*.log { daily rotate 7 compress delaycompress missingok notifempty create 0640 geode geode sharedscripts postrotate systemctl reload geode >/dev/null 2>&1 || true endscript } </code></pre></div><hr> <h3 id="security-configuration" class="position-relative d-flex align-items-center group"> Security Configuration <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-configuration" aria-haspopup="dialog" aria-label="Share link: Security Configuration"> Share link </button> </h3> <h4 id="encryption-at-rest-tde" class="position-relative d-flex align-items-center group"> Encryption at Rest (TDE) <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="encryption-at-rest-tde" aria-haspopup="dialog" aria-label="Share link: Encryption at Rest (TDE)"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">storage: enable_tde: true # Provide key via environment (never hardcode!) # disk_key_hex: from GEODE_DISK_KEY_HEX environment variable </code></pre></div>Generate Encryption Key: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Generate random 256-bit key openssl rand -hex 32 > /secure/location/tde-key.hex # Set environment variable export GEODE_DISK_KEY_HEX=$(cat /secure/location/tde-key.hex) # Or use KMS export GEODE_KMS_PROVIDER=vault export VAULT_TOKEN=$(vault login -token-only) </code></pre></div> <h4 id="kms-integration" class="position-relative d-flex align-items-center group"> KMS Integration <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="kms-integration" aria-haspopup="dialog" aria-label="Share link: KMS Integration"> Share link </button> </h4>HashiCorp Vault: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">security: kms_provider: 'vault' vault: address: 'https://vault.example.com:8200' token: '${VAULT_TOKEN}' # From environment mount_path: 'geode-keys' </code></pre></div>AWS KMS: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">security: kms_provider: 'aws' aws_kms: key_id: 'arn:aws:kms:us-east-1:123456789012:key/...' region: 'us-east-1' </code></pre></div><hr> <h3 id="monitoring-configuration" class="position-relative d-flex align-items-center group"> Monitoring Configuration <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="monitoring-configuration" aria-haspopup="dialog" aria-label="Share link: Monitoring Configuration"> Share link </button> </h3> <h4 id="prometheus-metrics" class="position-relative d-flex align-items-center group"> Prometheus Metrics <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="prometheus-metrics" aria-haspopup="dialog" aria-label="Share link: Prometheus Metrics"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">monitoring: metrics: enabled: true listen: '0.0.0.0:9090' </code></pre></div>Scrape Config (<code>prometheus.yml</code>): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">scrape_configs: - job_name: 'geode' static_configs: - targets: ['geode-server:9090'] scrape_interval: 15s </code></pre></div> <h4 id="health-checks" class="position-relative d-flex align-items-center group"> Health Checks <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="health-checks" aria-haspopup="dialog" aria-label="Share link: Health Checks"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">monitoring: health: enabled: true listen: '0.0.0.0:8080' </code></pre></div>Kubernetes Probes: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">livenessProbe: httpGet: path: /health port: 8080 initialDelaySeconds: 30 periodSeconds: 10 readinessProbe: httpGet: path: /ready port: 8080 initialDelaySeconds: 5 periodSeconds: 5 </code></pre></div><hr> <h3 id="troubleshooting-configuration" class="position-relative d-flex align-items-center group"> Troubleshooting Configuration <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="troubleshooting-configuration" aria-haspopup="dialog" aria-label="Share link: Troubleshooting Configuration"> Share link </button> </h3> <h4 id="common-issues" class="position-relative d-flex align-items-center group"> Common Issues <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="common-issues" aria-haspopup="dialog" aria-label="Share link: Common Issues"> Share link </button> </h4>Issue: Server won’t start with config file <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Check config syntax geode serve --config /etc/geode/config.yaml --validate # Use debug logging to see what's failing geode serve \ --config /etc/geode/config.yaml \ --log-level debug </code></pre></div>Issue: Environment variables not working <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Verify environment is set env | grep GEODE # Test with explicit values GEODE_LOG_LEVEL=debug geode serve </code></pre></div>Issue: TLS certificate errors <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># See TLS Certificate Setup section above # Verify certificate paths in config cat /etc/geode/config.yaml | grep -A 2 "tls:" # Check file permissions ls -la /etc/geode/tls/ </code></pre></div><hr> <h3 id="next-steps" class="position-relative d-flex align-items-center group"> Next Steps <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="next-steps" aria-haspopup="dialog" aria-label="Share link: Next Steps"> Share link </button> </h3><ul> <li><a href="/docs/ops/deployment/" >Deployment Guide</a> - Production deployment patterns</li> <li><a href="/docs/security/overview/" >Security Overview</a> - Authentication and encryption</li> <li><a href="/docs/ops/observability/" >Monitoring</a> - Metrics and observability</li> <li><a href="/docs/guides/troubleshooting/" >Troubleshooting</a> - Diagnose configuration issues</li> <li><a href="/docs/query/performance-tuning/" >Performance Tuning</a> - Optimize query performance</li> </ul>