<!-- CANARY: REQ=REQ-SERVER-STARTUP-INTEGRATION-001; FEATURE="Server Startup Integration Tests"; ASPECT=EndToEndServerTesting; STATUS=TESTED; OWNER=server; UPDATED=2025-10-05 -->
<h2 id="operations" class="position-relative d-flex align-items-center group">
<span>Operations</span>
<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="operations"
aria-haspopup="dialog"
aria-label="Share link: Operations">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h2><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">
<i class="fa-solid fa-xmark"></i>
</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">
<i class="fa-duotone fa-clipboard" aria-hidden="true"></i>
</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">
<i class="fa-brands fa-twitter me-2"></i>Twitter
</a>
<a id="share-linkedin" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer">
<i class="fa-brands fa-linkedin me-2"></i>LinkedIn
</a>
<a id="share-facebook" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer">
<i class="fa-brands fa-facebook me-2"></i>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><p>Comprehensive operational guides for deploying, monitoring, and maintaining Geode in production environments. From single-node installations to globally distributed clusters, these guides cover everything you need for operational excellence.</p>
<h3 id="overview" class="position-relative d-flex align-items-center group">
<span>Overview</span>
<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">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h3><p>Running Geode in production requires careful attention to deployment architecture, monitoring, security, and operational procedures. This section provides battle-tested guidance for operators, SREs, and DevOps engineers managing Geode systems.</p>
<p>Whether you’re deploying with Docker, Kubernetes, or bare metal, these guides cover deployment strategies, health monitoring, backup procedures, incident response, and compliance requirements. Built on real-world production experience, these practices ensure reliability, performance, and security.</p>
<h3 id="deployment-options" class="position-relative d-flex align-items-center group">
<span>Deployment Options</span>
<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="deployment-options"
aria-haspopup="dialog"
aria-label="Share link: Deployment Options">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h3>
<h4 id="docker-deployment" class="position-relative d-flex align-items-center group">
<span>Docker Deployment</span>
<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-deployment"
aria-haspopup="dialog"
aria-label="Share link: Docker Deployment">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><p>Containerized deployment with Docker and Docker Compose for development, testing, and production environments. Includes complete stack with Vault for secrets management, MinIO for backups, and full observability (Prometheus, Grafana, Loki).</p>
<p><strong>Best For</strong>: Cloud deployments, container orchestration, multi-service stacks</p>
<h4 id="kubernetes-deployment" class="position-relative d-flex align-items-center group">
<span>Kubernetes Deployment</span>
<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="kubernetes-deployment"
aria-haspopup="dialog"
aria-label="Share link: Kubernetes Deployment">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><p>Cloud-native deployment with Helm charts, StatefulSets, and Kubernetes operators. Includes auto-scaling, rolling updates, and integration with cloud-native ecosystems.</p>
<p><strong>Best For</strong>: Large-scale production, multi-tenant environments, cloud platforms</p>
<h4 id="bare-metal-deployment" class="position-relative d-flex align-items-center group">
<span>Bare Metal Deployment</span>
<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="bare-metal-deployment"
aria-haspopup="dialog"
aria-label="Share link: Bare Metal Deployment">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><p>Direct installation on physical or virtual servers for maximum performance and control. Includes systemd service configuration and system tuning.</p>
<p><strong>Best For</strong>: High-performance workloads, dedicated hardware, legacy environments</p>
<h3 id="topics-in-this-section" class="position-relative d-flex align-items-center group">
<span>Topics in This Section</span>
<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="topics-in-this-section"
aria-haspopup="dialog"
aria-label="Share link: Topics in This Section">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h3><ul>
<li><strong><a
href="/docs/ops/deployment/"
>Deployment</a>
</strong> - Complete production deployment guide with Vault, MinIO, Prometheus, Grafana, Loki, and Nginx reverse proxy</li>
<li><strong><a
href="/docs/ops/docker-deployment/"
>Docker Deployment</a>
</strong> - Docker and Docker Compose deployment including singleton and distributed cluster configurations</li>
<li><strong><a
href="/docs/ops/observability/"
>Observability</a>
</strong> - Monitoring, metrics, logging, and distributed tracing for production visibility</li>
<li><strong><a
href="/docs/ops/audit-logging/"
>Audit Logging</a>
</strong> - Comprehensive audit trail for compliance including GDPR, SOX, HIPAA, and PCI-DSS</li>
<li><strong><a
href="/docs/ops/telemetry-advanced/"
>Advanced Telemetry</a>
</strong> - Advanced telemetry patterns including distributed tracing, custom metrics, and log aggregation</li>
</ul>
<h3 id="observability-stack" class="position-relative d-flex align-items-center group">
<span>Observability Stack</span>
<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="observability-stack"
aria-haspopup="dialog"
aria-label="Share link: Observability Stack">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h3><p>Geode integrates with industry-standard observability tools:</p>
<h4 id="metrics-prometheus" class="position-relative d-flex align-items-center group">
<span>Metrics (Prometheus)</span>
<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="metrics-prometheus"
aria-haspopup="dialog"
aria-label="Share link: Metrics (Prometheus)">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><ul>
<li><strong>System Metrics</strong>: CPU, memory, disk, network utilization</li>
<li><strong>Query Metrics</strong>: Latency, throughput, error rates</li>
<li><strong>Storage Metrics</strong>: Page cache hit ratio, WAL writes, index operations</li>
<li><strong>Security Metrics</strong>: Authentication failures, authorization denials</li>
</ul>
<h4 id="logging-loki" class="position-relative d-flex align-items-center group">
<span>Logging (Loki)</span>
<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="logging-loki"
aria-haspopup="dialog"
aria-label="Share link: Logging (Loki)">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><ul>
<li><strong>Structured Logging</strong>: JSON-formatted logs with rich context</li>
<li><strong>Query Logging</strong>: Full GQL query text with execution time</li>
<li><strong>Audit Logging</strong>: Security events and data access logs</li>
<li><strong>Error Logging</strong>: Stack traces and error context</li>
</ul>
<h4 id="tracing-jaegertempo" class="position-relative d-flex align-items-center group">
<span>Tracing (Jaeger/Tempo)</span>
<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="tracing-jaegertempo"
aria-haspopup="dialog"
aria-label="Share link: Tracing (Jaeger/Tempo)">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><ul>
<li><strong>Distributed Tracing</strong>: End-to-end request tracing across services</li>
<li><strong>Query Tracing</strong>: Detailed execution plans with timing</li>
<li><strong>Federated Tracing</strong>: Cross-shard query coordination</li>
</ul>
<h4 id="dashboards-grafana" class="position-relative d-flex align-items-center group">
<span>Dashboards (Grafana)</span>
<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="dashboards-grafana"
aria-haspopup="dialog"
aria-label="Share link: Dashboards (Grafana)">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><ul>
<li><strong>System Health</strong>: Real-time system status and resource utilization</li>
<li><strong>Query Performance</strong>: Query latency, throughput, and error rates</li>
<li><strong>Security Dashboard</strong>: Authentication, authorization, and audit events</li>
<li><strong>Capacity Planning</strong>: Trend analysis and forecasting</li>
</ul>
<p>See <a
href="/docs/ops/observability/"
>Observability</a>
for complete setup.</p>
<h3 id="security-and-compliance" class="position-relative d-flex align-items-center group">
<span>Security and Compliance</span>
<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-and-compliance"
aria-haspopup="dialog"
aria-label="Share link: Security and Compliance">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h3>
<h4 id="audit-logging" class="position-relative d-flex align-items-center group">
<span>Audit Logging</span>
<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="audit-logging"
aria-haspopup="dialog"
aria-label="Share link: Audit Logging">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><p>Comprehensive audit trail for regulatory compliance:</p>
<ul>
<li><strong>Authentication Events</strong>: Login attempts, session creation, MFA challenges</li>
<li><strong>Authorization Events</strong>: Permission checks, policy evaluations</li>
<li><strong>Data Access</strong>: Query execution, data modifications</li>
<li><strong>Administrative Actions</strong>: Schema changes, user management</li>
<li><strong>System Events</strong>: Configuration changes, backup operations</li>
</ul>
<p>Supports compliance with:</p>
<ul>
<li>GDPR (data access and deletion tracking)</li>
<li>SOX (financial data access controls)</li>
<li>HIPAA (healthcare data access logging)</li>
<li>PCI-DSS (payment card data security)</li>
</ul>
<p>See <a
href="/docs/ops/audit-logging/"
>Audit Logging</a>
for configuration.</p>
<h4 id="encryption" class="position-relative d-flex align-items-center group">
<span>Encryption</span>
<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"
aria-haspopup="dialog"
aria-label="Share link: Encryption">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><ul>
<li><strong>At Rest</strong>: TDE (Transparent Data Encryption) with AES-256-GCM</li>
<li><strong>In Transit</strong>: TLS 1.3 mandatory for all connections</li>
<li><strong>Field-Level</strong>: Searchable encryption for sensitive fields</li>
<li><strong>Key Management</strong>: Integration with HashiCorp Vault</li>
</ul>
<p>See <a
href="/docs/security/overview/"
>Security Overview</a>
for details.</p>
<h3 id="deployment-architecture" class="position-relative d-flex align-items-center group">
<span>Deployment Architecture</span>
<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="deployment-architecture"
aria-haspopup="dialog"
aria-label="Share link: Deployment Architecture">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h3>
<h4 id="standalone-mode" class="position-relative d-flex align-items-center group">
<span>Standalone Mode</span>
<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="standalone-mode"
aria-haspopup="dialog"
aria-label="Share link: Standalone Mode">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">┌─────────────────────┐
</span></span><span class="line"><span class="cl">│ Geode Server │
</span></span><span class="line"><span class="cl">│ (QUIC:3141) │
</span></span><span class="line"><span class="cl">│ │
</span></span><span class="line"><span class="cl">│ ┌───────────────┐ │
</span></span><span class="line"><span class="cl">│ │ Storage │ │
</span></span><span class="line"><span class="cl">│ │ WAL │ │
</span></span><span class="line"><span class="cl">│ │ Indexes │ │
</span></span><span class="line"><span class="cl">│ └───────────────┘ │
</span></span><span class="line"><span class="cl">└─────────────────────┘
</span></span></code></pre></div>
<h4 id="distributed-mode" class="position-relative d-flex align-items-center group">
<span>Distributed Mode</span>
<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="distributed-mode"
aria-haspopup="dialog"
aria-label="Share link: Distributed Mode">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">┌──────────────┐ ┌──────────────┐ ┌──────────────┐
</span></span><span class="line"><span class="cl">│ Shard 1 │ │ Shard 2 │ │ Shard 3 │
</span></span><span class="line"><span class="cl">│ (QUIC:3141) │ │ (QUIC:3142) │ │ (QUIC:3143) │
</span></span><span class="line"><span class="cl">└──────┬───────┘ └──────┬───────┘ └──────┬───────┘
</span></span><span class="line"><span class="cl"> │ │ │
</span></span><span class="line"><span class="cl"> └─────────────────┼──────────────────┘
</span></span><span class="line"><span class="cl"> │
</span></span><span class="line"><span class="cl"> ┌────▼─────┐
</span></span><span class="line"><span class="cl"> │Coordinator│
</span></span><span class="line"><span class="cl"> │(Federation)│
</span></span><span class="line"><span class="cl"> └──────────┘
</span></span></code></pre></div>
<h4 id="full-production-stack" class="position-relative d-flex align-items-center group">
<span>Full Production Stack</span>
<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="full-production-stack"
aria-haspopup="dialog"
aria-label="Share link: Full Production Stack">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl"> ┌──────────────┐
</span></span><span class="line"><span class="cl"> │ Nginx │
</span></span><span class="line"><span class="cl"> │ (Load Bal) │
</span></span><span class="line"><span class="cl"> └──────┬───────┘
</span></span><span class="line"><span class="cl"> │
</span></span><span class="line"><span class="cl"> ┌──────────────────┼──────────────────┐
</span></span><span class="line"><span class="cl"> │ │ │
</span></span><span class="line"><span class="cl"> ┌────▼─────┐ ┌────▼─────┐ ┌────▼─────┐
</span></span><span class="line"><span class="cl"> │ Geode │ │ Geode │ │ Geode │
</span></span><span class="line"><span class="cl"> │ Server 1 │ │ Server 2 │ │ Server 3 │
</span></span><span class="line"><span class="cl"> └────┬─────┘ └────┬─────┘ └────┬─────┘
</span></span><span class="line"><span class="cl"> │ │ │
</span></span><span class="line"><span class="cl"> └─────────────────┼──────────────────┘
</span></span><span class="line"><span class="cl"> │
</span></span><span class="line"><span class="cl"> ┌─────────────────┼─────────────────┐
</span></span><span class="line"><span class="cl"> │ │ │
</span></span><span class="line"><span class="cl"> ┌────▼────┐ ┌────▼─────┐ ┌────▼────┐
</span></span><span class="line"><span class="cl"> │ Vault │ │ MinIO │ │Prometheus│
</span></span><span class="line"><span class="cl"> │ (KMS) │ │(Backups) │ │ Grafana │
</span></span><span class="line"><span class="cl"> └─────────┘ └──────────┘ │ Loki │
</span></span><span class="line"><span class="cl"> └──────────┘
</span></span></code></pre></div>
<h3 id="common-operations" class="position-relative d-flex align-items-center group">
<span>Common Operations</span>
<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-operations"
aria-haspopup="dialog"
aria-label="Share link: Common Operations">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h3>
<h4 id="health-checks" class="position-relative d-flex align-items-center group">
<span>Health Checks</span>
<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">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># Server health</span>
</span></span><span class="line"><span class="cl">curl http://localhost:8080/health
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Readiness check</span>
</span></span><span class="line"><span class="cl">curl http://localhost:8080/ready
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Metrics</span>
</span></span><span class="line"><span class="cl">curl http://localhost:8080/metrics
</span></span></code></pre></div>
<h4 id="backup-and-restore" class="position-relative d-flex align-items-center group">
<span>Backup and Restore</span>
<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="backup-and-restore"
aria-haspopup="dialog"
aria-label="Share link: Backup and Restore">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># Create backup</span>
</span></span><span class="line"><span class="cl">geode backup --output /backups/geode-backup-<span class="k">$(</span>date +%Y%m%d<span class="k">)</span>.tar.gz
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Restore from backup</span>
</span></span><span class="line"><span class="cl">geode restore --input /backups/geode-backup-20240101.tar.gz
</span></span></code></pre></div><p>See <a
href="/docs/guides/backup-automation/"
>Backup Automation</a>
for automation.</p>
<h4 id="log-management" class="position-relative d-flex align-items-center group">
<span>Log Management</span>
<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-management"
aria-haspopup="dialog"
aria-label="Share link: Log Management">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># View logs</span>
</span></span><span class="line"><span class="cl">journalctl -u geode -f
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Export logs</span>
</span></span><span class="line"><span class="cl">journalctl -u geode --since <span class="s2">"2024-01-01"</span> > geode-logs.txt
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Filter errors</span>
</span></span><span class="line"><span class="cl">journalctl -u geode -p err
</span></span></code></pre></div>
<h4 id="performance-tuning" class="position-relative d-flex align-items-center group">
<span>Performance Tuning</span>
<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">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="c"># geode.yaml</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">storage</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">page_cache_size</span><span class="p">:</span><span class="w"> </span><span class="s1">'16GB'</span><span class="w"> </span><span class="c"># Adjust based on RAM</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">page_size</span><span class="p">:</span><span class="w"> </span><span class="m">8192</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">query</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">max_concurrent_queries</span><span class="p">:</span><span class="w"> </span><span class="m">1000</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">query_timeout</span><span class="p">:</span><span class="w"> </span><span class="l">30s</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">network</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">max_connections</span><span class="p">:</span><span class="w"> </span><span class="m">10000</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">connection_timeout</span><span class="p">:</span><span class="w"> </span><span class="l">30s</span><span class="w">
</span></span></span></code></pre></div>
<h3 id="best-practices" class="position-relative d-flex align-items-center group">
<span>Best Practices</span>
<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"
aria-haspopup="dialog"
aria-label="Share link: Best Practices">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h3>
<h4 id="deployment" class="position-relative d-flex align-items-center group">
<span>Deployment</span>
<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="deployment"
aria-haspopup="dialog"
aria-label="Share link: Deployment">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><ul>
<li>Use configuration management (Ansible, Terraform)</li>
<li>Implement blue-green or canary deployments</li>
<li>Test deployments in staging environment</li>
<li>Document deployment procedures</li>
<li>Maintain deployment runbooks</li>
</ul>
<h4 id="monitoring" class="position-relative d-flex align-items-center group">
<span>Monitoring</span>
<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"
aria-haspopup="dialog"
aria-label="Share link: Monitoring">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><ul>
<li>Set up health check endpoints</li>
<li>Configure alerts for critical metrics</li>
<li>Monitor resource utilization trends</li>
<li>Implement SLO-based alerting</li>
<li>Regular capacity planning reviews</li>
</ul>
<h4 id="security" class="position-relative d-flex align-items-center group">
<span>Security</span>
<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"
aria-haspopup="dialog"
aria-label="Share link: Security">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><ul>
<li>Enable TLS 1.3 for all connections</li>
<li>Implement RBAC with least privilege</li>
<li>Enable audit logging for compliance</li>
<li>Rotate credentials regularly</li>
<li>Regular security audits</li>
</ul>
<h4 id="backup" class="position-relative d-flex align-items-center group">
<span>Backup</span>
<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="backup"
aria-haspopup="dialog"
aria-label="Share link: Backup">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><ul>
<li>Daily incremental backups</li>
<li>Weekly full backups</li>
<li>Test restore procedures quarterly</li>
<li>Store backups in separate location</li>
<li>Encrypt backups at rest</li>
</ul>
<h4 id="maintenance" class="position-relative d-flex align-items-center group">
<span>Maintenance</span>
<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="maintenance"
aria-haspopup="dialog"
aria-label="Share link: Maintenance">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h4><ul>
<li>Regular version updates</li>
<li>Index maintenance and optimization</li>
<li>Log rotation and archival</li>
<li>Certificate renewal</li>
<li>Documentation updates</li>
</ul>
<h3 id="troubleshooting" class="position-relative d-flex align-items-center group">
<span>Troubleshooting</span>
<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"
aria-haspopup="dialog"
aria-label="Share link: Troubleshooting">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h3><p>Common operational issues:</p>
<ul>
<li><strong>High CPU</strong>: Check slow queries with EXPLAIN, review indexes</li>
<li><strong>High Memory</strong>: Adjust page cache size, check for memory leaks</li>
<li><strong>High Disk I/O</strong>: Review write patterns, check WAL configuration</li>
<li><strong>Connection Errors</strong>: Check firewall rules, verify TLS certificates</li>
<li><strong>Query Timeouts</strong>: Review query complexity, check resource limits</li>
</ul>
<p>See <a
href="/docs/guides/troubleshooting/"
>Troubleshooting Guide</a>
for detailed solutions.</p>
<h3 id="learn-more" class="position-relative d-flex align-items-center group">
<span>Learn More</span>
<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="learn-more"
aria-haspopup="dialog"
aria-label="Share link: Learn More">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h3><ul>
<li><a
href="/docs/deployment/deployment-patterns/"
>Deployment Patterns</a>
- Deployment architectures</li>
<li><a
href="/docs/configuration/"
>Configuration Reference</a>
- Server configuration options</li>
<li><a
href="/docs/security/overview/"
>Security Overview</a>
- Security architecture</li>
<li><a
href="/docs/guides/performance-benchmarking/"
>Performance Benchmarking</a>
- Benchmark procedures</li>
<li><a
href="/docs/guides/multi-datacenter/"
>Multi-Datacenter Guide</a>
- Multi-region deployment</li>
</ul>
<h3 id="getting-help" class="position-relative d-flex align-items-center group">
<span>Getting Help</span>
<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="getting-help"
aria-haspopup="dialog"
aria-label="Share link: Getting Help">
<i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i>
<span class="visually-hidden">Share link</span>
</button>
</h3><p>For operational issues:</p>
<ol>
<li>Check <a
href="/docs/guides/troubleshooting/"
>Troubleshooting Guide</a>
</li>
<li>Review <a
href="/docs/reference/error-codes/"
>Error Codes</a>
</li>
<li>Check system logs and metrics</li>
<li>Review <a
href="/docs/architecture/"
>Architecture Documentation</a>
</li>
<li>Report issues with detailed diagnostics</li>
</ol>
Operations
Operational guides for deploying, monitoring, and maintaining Geode in production environments
5 pages
Pages
Deployment and Integration Guide
Deploy Geode with Docker Compose or Kubernetes, configure Vault/MinIO/Prometheus/Grafana, set up S3 backups and CDC/webhooks, and integrate client libraries
6 min read
Monitoring and Telemetry
Monitor Geode with health checks and Prometheus metrics, enable optional paging telemetry, and configure tamper-evident audit logging with tracing IDs
6 min read
Docker Deployment Guide
Complete guide to deploying Geode graph database with Docker: pre-built images, development environment, production deployment, and distributed clusters
11 min read
Advanced Telemetry and Monitoring Guide
Complete guide to Geode's telemetry system including custom metrics, Prometheus integration, Grafana dashboards, paging events, and advanced monitoring patterns.
9 min read
Audit Logging and Compliance
Comprehensive audit logging system in Geode with tamper-evident hash chains, RFC 5424 syslog integration, and enterprise compliance for SOX, PCI-DSS, and HIPAA requirements.
13 min read