Docker Deployment Guide | Geode Database

<h2 id="docker-deployment-guide" class="position-relative d-flex align-items-center group"> Docker Deployment Guide <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-guide" aria-haspopup="dialog" aria-label="Share link: Docker Deployment Guide"> Share link </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"> </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>Complete documentation for containerized deployment of Geode graph database using Docker and Docker Compose. <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>Geode offers multiple Docker deployment options: <ul> <li>Pre-built images from <a href="https://hub.docker.com/r/geodedb/geode" aria-label="Docker Hub – opens in new window" target="_blank" rel="noopener noreferrer" >Docker Hub ↗ </a> (fastest)</li> <li>Development environment with complete toolchain</li> <li>Production deployment with multi-stage builds</li> <li>Distributed clusters with 3-node Raft consensus</li> </ul> All Geode Docker containers use QUIC+TLS over UDP port 8443 for secure, high-performance communication. <h3 id="quick-start" class="position-relative d-flex align-items-center group"> Quick Start <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="quick-start" aria-haspopup="dialog" aria-label="Share link: Quick Start"> Share link </button> </h3> <h4 id="using-pre-built-images-5-minutes" class="position-relative d-flex align-items-center group"> Using Pre-built Images (5 Minutes) <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="using-pre-built-images-5-minutes" aria-haspopup="dialog" aria-label="Share link: Using Pre-built Images (5 Minutes)"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Pull the latest image from Docker Hub docker pull geodedb/geode:latest # Run the container docker run -d -p 3141:3141/udp --name geode geodedb/geode:latest # Test connectivity docker exec geode geode query "RETURN 1 AS health" --server 127.0.0.1:3141 </code></pre></div>Expected output: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">Column: health 1 </code></pre></div> <h4 id="using-docker-compose" class="position-relative d-flex align-items-center group"> Using Docker Compose <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="using-docker-compose" aria-haspopup="dialog" aria-label="Share link: Using Docker Compose"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">version: '3.8' services: geode: image: geodedb/geode:latest container_name: geode-server ports: - "3141:3141/udp" - "9090:9090" volumes: - geode-data:/data environment: - GEODE_LOG_LEVEL=info restart: unless-stopped healthcheck: test: ["CMD", "geode", "query", "RETURN 1", "--server", "127.0.0.1:3141"] interval: 30s timeout: 3s retries: 3 volumes: geode-data: </code></pre></div> <h3 id="available-docker-images" class="position-relative d-flex align-items-center group"> Available Docker Images <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="available-docker-images" aria-haspopup="dialog" aria-label="Share link: Available Docker Images"> Share link </button> </h3>Geode images are available on <a href="https://hub.docker.com/r/geodedb/geode" aria-label="Docker Hub – opens in new window" target="_blank" rel="noopener noreferrer" >Docker Hub ↗ </a> with multiple variants optimized for different use cases: <table> <thead> <tr> <th>Image Tag</th> <th>Base</th> <th>Size</th> <th>Use Case</th> </tr> </thead> <tbody> <tr> <td><code>latest</code></td> <td>Debian Bookworm</td> <td>~250MB</td> <td>General purpose (recommended)</td> </tr> <tr> <td><code>alpine</code></td> <td>Alpine 3.19</td> <td>~80MB</td> <td>Minimal size, musl libc</td> </tr> <tr> <td><code>gpu</code></td> <td>NVIDIA CUDA 12.6</td> <td>~1.2GB</td> <td>GPU acceleration support</td> </tr> <tr> <td><code>prod</code></td> <td>Distroless</td> <td>~180MB</td> <td>Production, minimal attack surface</td> </tr> </tbody> </table> <h4 id="pull-commands" class="position-relative d-flex align-items-center group"> Pull Commands <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="pull-commands" aria-haspopup="dialog" aria-label="Share link: Pull Commands"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Standard (recommended for most deployments) docker pull geodedb/geode:latest # Alpine (minimal size) docker pull geodedb/geode:alpine # GPU support (vector operations, graph algorithms) docker pull geodedb/geode:gpu # Production optimized (distroless base) docker pull geodedb/geode:prod </code></pre></div> <h3 id="development-environment" class="position-relative d-flex align-items-center group"> Development Environment <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-environment" aria-haspopup="dialog" aria-label="Share link: Development Environment"> Share link </button> </h3>A complete Docker-based development environment replicating the local development stack. <h4 id="whats-included" class="position-relative d-flex align-items-center group"> What&rsquo;s Included <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="whats-included" aria-haspopup="dialog" aria-label="Share link: Whats Included"> Share link </button> </h4><ul> <li>Zig 0.1.0 - Primary build system</li> <li>Python 3.12 - Test harness and geodetestlab</li> <li>OpenSSL 3.3.2 with FIPS - Enterprise cryptography</li> <li>MsQUIC v2.5.4 - High-performance QUIC implementation</li> <li>HashiCorp Vault - Secrets management</li> <li>MinIO - S3-compatible storage</li> <li>Redis - Caching layer</li> <li>Optional: Prometheus + Grafana monitoring</li> </ul> <h4 id="prerequisites" class="position-relative d-flex align-items-center group"> Prerequisites <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="prerequisites" aria-haspopup="dialog" aria-label="Share link: Prerequisites"> Share link </button> </h4><ul> <li>Docker 20.10+</li> <li>Docker Compose 1.29+</li> <li>8GB+ RAM</li> <li>20GB+ disk space</li> </ul> <h4 id="setup--usage" class="position-relative d-flex align-items-center group"> Setup &amp; Usage <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="setup--usage" aria-haspopup="dialog" aria-label="Share link: Setup &amp; Usage"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Clone repository git clone https://github.com/codeprosorg/geode cd geode # Start development environment (first build ~10 minutes) ./dev.sh start # Check service health ./dev.sh status # Enter development shell ./dev.sh shell # Build Geode (inside shell) zb # Debug build zbr # Release build zbt # Build with tests # Run tests make test make geodetestlab make verify-fast # Start Geode server geode serve --listen 127.0.0.1:9999 # View logs ./dev.sh logs -f # Stop environment ./dev.sh stop # Full cleanup (removes volumes) ./dev.sh down </code></pre></div> <h4 id="development-commands-reference" class="position-relative d-flex align-items-center group"> Development Commands Reference <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-commands-reference" aria-haspopup="dialog" aria-label="Share link: Development Commands Reference"> Share link </button> </h4><table> <thead> <tr> <th>Command</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>./dev.sh start</code></td> <td>Start development environment</td> </tr> <tr> <td><code>./dev.sh stop</code></td> <td>Stop development environment</td> </tr> <tr> <td><code>./dev.sh restart</code></td> <td>Restart development environment</td> </tr> <tr> <td><code>./dev.sh shell</code></td> <td>Open interactive shell</td> </tr> <tr> <td><code>./dev.sh exec <cmd></code></td> <td>Execute command in container</td> </tr> <tr> <td><code>./dev.sh build</code></td> <td>Build geode project</td> </tr> <tr> <td><code>./dev.sh test</code></td> <td>Run tests</td> </tr> <tr> <td><code>./dev.sh clean</code></td> <td>Clean build artifacts</td> </tr> <tr> <td><code>./dev.sh logs [-f]</code></td> <td>View logs (optionally follow)</td> </tr> <tr> <td><code>./dev.sh status</code></td> <td>Show service status</td> </tr> <tr> <td><code>./dev.sh down</code></td> <td>Remove containers and volumes</td> </tr> <tr> <td><code>./dev.sh rebuild</code></td> <td>Rebuild Docker image</td> </tr> <tr> <td><code>./dev.sh monitoring</code></td> <td>Start with Prometheus + Grafana</td> </tr> </tbody> </table> <h4 id="service-access" class="position-relative d-flex align-items-center group"> Service Access <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="service-access" aria-haspopup="dialog" aria-label="Share link: Service Access"> Share link </button> </h4>When running the development environment, these services are available: <table> <thead> <tr> <th>Service</th> <th>Port</th> <th>Credentials</th> </tr> </thead> <tbody> <tr> <td>Vault</td> <td>8200</td> <td>Token: <code>geode-dev-token</code></td> </tr> <tr> <td>MinIO Console</td> <td>9001</td> <td><code>admin</code> / <code>geode-dev-secret-123</code></td> </tr> <tr> <td>Redis</td> <td>6379</td> <td>Password: <code>geode-dev-password</code></td> </tr> <tr> <td>Prometheus</td> <td>9090</td> <td>None</td> </tr> <tr> <td>Grafana</td> <td>3000</td> <td><code>admin</code> / <code>geode-dev-password</code></td> </tr> </tbody> </table> <h3 id="production-deployment" class="position-relative d-flex align-items-center group"> Production 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="production-deployment" aria-haspopup="dialog" aria-label="Share link: Production Deployment"> Share link </button> </h3> <h4 id="building-production-images" class="position-relative d-flex align-items-center group"> Building Production Images <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="building-production-images" aria-haspopup="dialog" aria-label="Share link: Building Production Images"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Build complete production image ./docker-build.sh all geode:latest # Or build specific stages ./docker-build.sh openssl # OpenSSL FIPS only ./docker-build.sh msquic # MsQUIC only ./docker-build.sh builder # Full Geode build ./docker-build.sh runtime # Production runtime </code></pre></div> <h4 id="multi-stage-build-architecture" class="position-relative d-flex align-items-center group"> Multi-Stage Build Architecture <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="multi-stage-build-architecture" aria-haspopup="dialog" aria-label="Share link: Multi-Stage Build Architecture"> Share link </button> </h4>Geode uses a four-stage build process for optimal security and size: <ol> <li>Stage 1 - OpenSSL FIPS Builder: Compiles OpenSSL 3.3.2 with FIPS 140-3 module</li> <li>Stage 2 - MsQUIC Builder: Builds Microsoft MsQUIC v2.5.5 for high-performance QUIC</li> <li>Stage 3 - Geode Builder: Compiles Geode with all dependencies</li> <li>Stage 4 - Runtime: Minimal Debian base with only runtime dependencies</li> </ol> <h4 id="single-node-production-deployment" class="position-relative d-flex align-items-center group"> Single-Node Production 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="single-node-production-deployment" aria-haspopup="dialog" aria-label="Share link: Single-Node Production Deployment"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Run with production configuration docker run -d \ --name geode-prod \ --restart=unless-stopped \ -p 8443:8443/udp \ -v /var/lib/geode:/data \ -v /etc/geode/certs:/certs:ro \ -e LOG_LEVEL=warn \ geode:latest \ --data-dir /data \ --cert /certs/server.crt \ --key /certs/server.key \ --listen 0.0.0.0:8443 </code></pre></div> <h4 id="docker-compose-production-configuration" class="position-relative d-flex align-items-center group"> Docker Compose 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="docker-compose-production-configuration" aria-haspopup="dialog" aria-label="Share link: Docker Compose Production Configuration"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">version: '3.8' services: geode: image: geodedb/geode:prod container_name: geode-server ports: - "8443:8443/udp" - "9090:9090" volumes: - geode-data:/data - ./certs:/certs:ro - ./logs:/var/log/geode environment: - GEODE_LOG_LEVEL=warn - GEODE_MAX_CONNECTIONS=1000 - GEODE_CACHE_SIZE=2GB - FIPS_MODE=enabled restart: unless-stopped read_only: true tmpfs: - /tmp security_opt: - no-new-privileges:true cap_drop: - ALL cap_add: - NET_BIND_SERVICE deploy: resources: limits: cpus: '4' memory: 8G reservations: cpus: '2' memory: 4G healthcheck: test: ["CMD", "geode", "query", "RETURN 1", "--server", "127.0.0.1:8443"] interval: 30s timeout: 3s retries: 3 start_period: 10s volumes: geode-data: driver: local </code></pre></div> <h4 id="with-tls-certificates" class="position-relative d-flex align-items-center group"> With TLS Certificates <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="with-tls-certificates" aria-haspopup="dialog" aria-label="Share link: With TLS Certificates"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Generate self-signed certificates docker run --rm -v ./certs:/certs geodedb/geode:latest \ cert_gen --output-dir /certs # Run with custom certificates docker run -d \ -p 8443:8443/udp \ -v ./certs:/certs:ro \ -v ./data:/data \ geodedb/geode:latest \ --data-dir /data \ --cert /certs/server.crt \ --key /certs/server.key \ --listen 0.0.0.0:8443 # Verify certificate openssl x509 -in ./certs/server.crt -text -noout </code></pre></div> <h4 id="with-persistent-data" class="position-relative d-flex align-items-center group"> With Persistent Data <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="with-persistent-data" aria-haspopup="dialog" aria-label="Share link: With Persistent Data"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Create data directory mkdir -p ./data # Run with persistent storage docker run -d \ --name geode \ -p 8443:8443/udp \ -v $(pwd)/data:/data \ geodedb/geode:latest \ --data-dir /data </code></pre></div> <h3 id="distributed-deployment" class="position-relative d-flex align-items-center group"> Distributed 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="distributed-deployment" aria-haspopup="dialog" aria-label="Share link: Distributed Deployment"> Share link </button> </h3>Deploy a 3-node Geode cluster with Raft consensus for high availability. <h4 id="architecture" class="position-relative d-flex align-items-center group"> Architecture <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="architecture" aria-haspopup="dialog" aria-label="Share link: Architecture"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"> ┌──────────────┐ │ HAProxy │ │ LB (7500) │ └──────┬───────┘ │ ┌─────────┴──────────┬──────────┐ │ │ │ ┌───▼────┐ ┌────▼────┐ ┌───▼────┐ │ Leader │◄────────► Follow-1│ │Follow-2│ │ 7567 │ Raft │ 7569 │ │ 7571 │ └────────┘ └─────────┘ └────────┘ </code></pre></div> <h4 id="quick-start-1" class="position-relative d-flex align-items-center group"> Quick Start <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="quick-start-1" aria-haspopup="dialog" aria-label="Share link: Quick Start"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Start distributed cluster make docker-up-distributed # Or manually: docker-compose -f docker-compose.distributed.yml up -d # Check cluster status docker-compose -f docker-compose.distributed.yml ps # View logs docker-compose -f docker-compose.distributed.yml logs -f # Stop cluster docker-compose -f docker-compose.distributed.yml down </code></pre></div> <h4 id="cluster-environment-variables" class="position-relative d-flex align-items-center group"> Cluster 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="cluster-environment-variables" aria-haspopup="dialog" aria-label="Share link: Cluster Environment Variables"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">NODE_ID=node-1 NODE_ROLE=leader|follower CLUSTER_NAME=geode-cluster GEODE_DISTRIBUTED=true GEODE_SHARD_COUNT=3 GEODE_REPLICATION_FACTOR=2 </code></pre></div> <h4 id="example-distributed-configuration" class="position-relative d-flex align-items-center group"> Example Distributed 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="example-distributed-configuration" aria-haspopup="dialog" aria-label="Share link: Example Distributed Configuration"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">version: '3.8' services: geode-node-1: image: geodedb/geode:latest container_name: geode-leader ports: - "7567:8443/udp" environment: - NODE_ID=node-1 - NODE_ROLE=leader - CLUSTER_NAME=geode-cluster - GEODE_DISTRIBUTED=true volumes: - geode-node-1:/data networks: - geode-cluster geode-node-2: image: geodedb/geode:latest container_name: geode-follower-1 ports: - "7569:8443/udp" environment: - NODE_ID=node-2 - NODE_ROLE=follower - CLUSTER_NAME=geode-cluster - GEODE_DISTRIBUTED=true - LEADER_HOST=geode-node-1 volumes: - geode-node-2:/data networks: - geode-cluster depends_on: - geode-node-1 geode-node-3: image: geodedb/geode:latest container_name: geode-follower-2 ports: - "7571:8443/udp" environment: - NODE_ID=node-3 - NODE_ROLE=follower - CLUSTER_NAME=geode-cluster - GEODE_DISTRIBUTED=true - LEADER_HOST=geode-node-1 volumes: - geode-node-3:/data networks: - geode-cluster depends_on: - geode-node-1 haproxy: image: haproxy:2.8 container_name: geode-lb ports: - "7500:7500" volumes: - ./haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro networks: - geode-cluster depends_on: - geode-node-1 - geode-node-2 - geode-node-3 networks: geode-cluster: driver: bridge volumes: geode-node-1: geode-node-2: geode-node-3: </code></pre></div> <h3 id="configuration-reference" class="position-relative d-flex align-items-center group"> Configuration Reference <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-reference" aria-haspopup="dialog" aria-label="Share link: Configuration Reference"> Share link </button> </h3> <h4 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> </h4><table> <thead> <tr> <th>Variable</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr> <td><code>GEODE_LOG_LEVEL</code></td> <td>Log level (debug, info, warn, error)</td> <td>info</td> </tr> <tr> <td><code>GEODE_MAX_CONNECTIONS</code></td> <td>Maximum concurrent connections</td> <td>1000</td> </tr> <tr> <td><code>GEODE_CACHE_SIZE</code></td> <td>Query cache size</td> <td>1GB</td> </tr> <tr> <td><code>GEODE_WAL_SIZE_LIMIT</code></td> <td>WAL size limit</td> <td>10GB</td> </tr> <tr> <td><code>LOG_LEVEL</code></td> <td>Alternative log level env var</td> <td>error</td> </tr> <tr> <td><code>FIPS_MODE</code></td> <td>Enable FIPS 140-3 mode</td> <td>enabled</td> </tr> <tr> <td><code>NODE_ID</code></td> <td>Cluster node identifier</td> <td>-</td> </tr> <tr> <td><code>NODE_ROLE</code></td> <td>Cluster role (leader/follower)</td> <td>-</td> </tr> <tr> <td><code>CLUSTER_NAME</code></td> <td>Cluster name for discovery</td> <td>-</td> </tr> <tr> <td><code>GEODE_DISTRIBUTED</code></td> <td>Enable distributed mode</td> <td>false</td> </tr> </tbody> </table> <h4 id="volume-mounts" class="position-relative d-flex align-items-center group"> Volume Mounts <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="volume-mounts" aria-haspopup="dialog" aria-label="Share link: Volume Mounts"> Share link </button> </h4><table> <thead> <tr> <th>Path</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>/data</code></td> <td>Persistent data storage (WAL, pages, indexes)</td> </tr> <tr> <td><code>/certs</code></td> <td>TLS certificates (read-only recommended)</td> </tr> <tr> <td><code>/var/log/geode</code></td> <td>Application logs</td> </tr> <tr> <td><code>/config</code></td> <td>Configuration files</td> </tr> </tbody> </table> <h4 id="ports" class="position-relative d-flex align-items-center group"> Ports <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="ports" aria-haspopup="dialog" aria-label="Share link: Ports"> Share link </button> </h4><table> <thead> <tr> <th>Port</th> <th>Protocol</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>8443</td> <td>UDP</td> <td>QUIC with TLS 1.3 (primary communication)</td> </tr> <tr> <td>9090</td> <td>TCP</td> <td>Prometheus metrics endpoint</td> </tr> <tr> <td>3141</td> <td>UDP</td> <td>Alternative QUIC port (standard)</td> </tr> </tbody> </table> <h3 id="security--fips" class="position-relative d-flex align-items-center group"> Security &amp; FIPS <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--fips" aria-haspopup="dialog" aria-label="Share link: Security &amp; FIPS"> Share link </button> </h3> <h4 id="fips-mode" class="position-relative d-flex align-items-center group"> FIPS Mode <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="fips-mode" aria-haspopup="dialog" aria-label="Share link: FIPS Mode"> Share link </button> </h4>OpenSSL FIPS 140-3 module is enabled by default in production images. Verify with: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Check OpenSSL version docker run --rm geodedb/geode:latest openssl version -a # Check FIPS providers docker exec <container> openssl list -providers </code></pre></div>Expected output: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">OpenSSL 3.3.2 with FIPS provider Providers: fips name: OpenSSL FIPS Provider version: 3.0.9 </code></pre></div> <h4 id="security-best-practices" class="position-relative d-flex align-items-center group"> Security Best Practices <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-best-practices" aria-haspopup="dialog" aria-label="Share link: Security Best Practices"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">services: geode: image: geodedb/geode:prod read_only: true # Immutable filesystem tmpfs: - /tmp # Writable temp only security_opt: - no-new-privileges:true # Prevent privilege escalation cap_drop: - ALL # Drop all capabilities cap_add: - NET_BIND_SERVICE # Only bind to privileged ports user: "1000:1000" # Run as non-root </code></pre></div> <h4 id="tls-certificate-management" class="position-relative d-flex align-items-center group"> TLS Certificate Management <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-management" aria-haspopup="dialog" aria-label="Share link: TLS Certificate Management"> 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 -nodes \ -keyout server.key \ -out server.crt \ -days 365 \ -subj "/CN=geode.example.com" # Or use Geode's built-in generator docker run --rm -v ./certs:/certs geodedb/geode:latest \ cert_gen --output-dir /certs --days 365 # Verify certificate openssl x509 -in ./certs/server.crt -text -noout | grep -A 2 "Validity" </code></pre></div> <h3 id="gpu-acceleration" class="position-relative d-flex align-items-center group"> GPU Acceleration <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="gpu-acceleration" aria-haspopup="dialog" aria-label="Share link: GPU Acceleration"> Share link </button> </h3>For vector operations and graph algorithms with GPU acceleration: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Pull GPU-enabled image docker pull geodedb/geode:gpu # Run with GPU support docker run -d \ --name geode-gpu \ --gpus all \ -p 8443:8443/udp \ geodedb/geode:gpu # Verify CUDA availability docker exec geode-gpu nvidia-smi </code></pre></div>Docker Compose with GPU: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">services: geode-gpu: image: geodedb/geode:gpu deploy: resources: reservations: devices: - driver: nvidia count: 1 capabilities: [gpu] </code></pre></div> <h3 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> </h3> <h4 id="udp-buffer-sizes-for-quic" class="position-relative d-flex align-items-center group"> UDP Buffer Sizes for QUIC <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="udp-buffer-sizes-for-quic" aria-haspopup="dialog" aria-label="Share link: UDP Buffer Sizes for QUIC"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Increase UDP buffer sizes for high-throughput docker run \ --sysctl net.core.rmem_max=26214400 \ --sysctl net.core.wmem_max=26214400 \ --ulimit nofile=65536:65536 \ geodedb/geode:latest </code></pre></div> <h4 id="resource-limits" class="position-relative d-flex align-items-center group"> Resource Limits <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="resource-limits" aria-haspopup="dialog" aria-label="Share link: Resource Limits"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">deploy: resources: limits: cpus: '8' memory: 16G reservations: cpus: '4' memory: 8G </code></pre></div> <h4 id="connection-limits" class="position-relative d-flex align-items-center group"> Connection Limits <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-limits" aria-haspopup="dialog" aria-label="Share link: Connection Limits"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Increase connection limits docker run -e GEODE_MAX_CONNECTIONS=10000 \ -e GEODE_CACHE_SIZE=4GB \ geodedb/geode:latest </code></pre></div> <h3 id="monitoring--health-checks" class="position-relative d-flex align-items-center group"> Monitoring &amp; 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="monitoring--health-checks" aria-haspopup="dialog" aria-label="Share link: Monitoring &amp; Health Checks"> Share link </button> </h3> <h4 id="health-check-configuration" class="position-relative d-flex align-items-center group"> Health Check 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="health-check-configuration" aria-haspopup="dialog" aria-label="Share link: Health Check Configuration"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">healthcheck: test: ["CMD", "geode", "query", "RETURN 1", "--server", "127.0.0.1:8443"] interval: 30s timeout: 3s retries: 3 start_period: 10s </code></pre></div> <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>Geode exposes Prometheus metrics on port 9090: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Access metrics curl http://localhost:9090/metrics # Example metrics geode_query_duration_seconds geode_storage_pages_written_total geode_connections_active geode_wal_segments_total </code></pre></div> <h4 id="integration-with-prometheus" class="position-relative d-flex align-items-center group"> Integration with Prometheus <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="integration-with-prometheus" aria-haspopup="dialog" aria-label="Share link: Integration with Prometheus"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"># prometheus.yml scrape_configs: - job_name: 'geode' static_configs: - targets: ['geode:9090'] </code></pre></div> <h3 id="troubleshooting" class="position-relative d-flex align-items-center group"> Troubleshooting <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"> Share link </button> </h3> <h4 id="container-wont-start" class="position-relative d-flex align-items-center group"> Container Won&rsquo;t Start <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="container-wont-start" aria-haspopup="dialog" aria-label="Share link: Container Wont Start"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Check logs docker logs geode # For Docker Compose docker-compose logs geode # Verify port availability (UDP!) netstat -uapn | grep 8443 </code></pre></div> <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>1. Port Already in Use <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Error: address already in use # Solution: Change host port docker run -p 9443:8443/udp geodedb/geode:latest </code></pre></div>2. Permission Errors <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Fix ownership sudo chown -R $(id -u):$(id -g) ./data # Or set UID/GID in environment echo "USER_UID=$(id -u)" > .env echo "USER_GID=$(id -g)" >> .env </code></pre></div>3. Health Check Failures <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Test manually (note: UDP, not TCP!) docker exec geode geode query "RETURN 1" --server 127.0.0.1:8443 # Check server is listening on UDP docker exec geode netstat -uapn | grep 8443 </code></pre></div>4. Certificate Errors <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Verify certificate validity openssl x509 -in ./certs/server.crt -noout -dates # Check certificate matches key openssl x509 -in ./certs/server.crt -noout -modulus | md5sum openssl rsa -in ./certs/server.key -noout -modulus | md5sum # Both MD5 sums should match </code></pre></div> <h4 id="debug-mode" class="position-relative d-flex align-items-center group"> Debug Mode <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="debug-mode" aria-haspopup="dialog" aria-label="Share link: Debug Mode"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Enable debug logging docker run -e GEODE_LOG_LEVEL=debug geodedb/geode:latest # Attach for debugging docker exec -it geode /bin/bash # View real-time logs docker logs -f --tail 100 geode </code></pre></div> <h4 id="build-failures" class="position-relative d-flex align-items-center group"> Build Failures <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="build-failures" aria-haspopup="dialog" aria-label="Share link: Build Failures"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Rebuild from scratch ./dev.sh rebuild # Try simple Dockerfile docker build -f Dockerfile.simple -t geode:latest . # Check Docker daemon logs sudo journalctl -u docker.service -f </code></pre></div> <h3 id="integration-testing" class="position-relative d-flex align-items-center group"> Integration 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="integration-testing" aria-haspopup="dialog" aria-label="Share link: Integration Testing"> Share link </button> </h3>Geode includes a comprehensive Docker integration test suite: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Run full integration test suite make docker-integration-test # View test results cat docker-integration/results/integration_summary.json # Run specific client tests docker-compose -f docker-integration/docker-compose.integration.yml up client-go docker-compose -f docker-integration/docker-compose.integration.yml up client-python docker-compose -f docker-integration/docker-compose.integration.yml up client-rust docker-compose -f docker-integration/docker-compose.integration.yml up client-zig </code></pre></div> <h4 id="test-architecture" class="position-relative d-flex align-items-center group"> Test Architecture <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-architecture" aria-haspopup="dialog" aria-label="Share link: Test Architecture"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"> ┌─────────────────┐ │ geode-server │ │ QUIC/TLS UDP:8443│ └────────┬────────┘ │ ┌──────────────────────┼──────────────────────┐ │ │ │ ┌─────▼──────┐ ┌──────────▼──────────┐ ┌───────▼────────┐ │ migration │ │ Client Tests │ │ results- │ │ runner │ │ (run in parallel) │ │ collector │ │ │ │ │ │ │ │ • Executes │ │ • client-go │ │ • Aggregates │ │ multi- │ │ • client-python │ │ test results │ │ statement│ │ • client-rust │ │ • Generates │ │ .gql │ │ • client-zig │ │ summary.json │ └────────────┘ └──────────────────────┘ └────────────────┘ </code></pre></div> <h3 id="docker-files-reference" class="position-relative d-flex align-items-center group"> Docker Files Reference <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-files-reference" aria-haspopup="dialog" aria-label="Share link: Docker Files Reference"> Share link </button> </h3><ul> <li><code>Dockerfile</code> - Multi-stage production build</li> <li><code>Dockerfile.dev</code> - Development environment with full toolchain</li> <li><code>Dockerfile.simple</code> - Fallback with inline Zig installation</li> <li><code>Dockerfile.prod</code> - Distroless production image</li> <li><code>docker-compose.yml</code> - Standard single-node deployment</li> <li><code>docker-compose.dev.yml</code> - Development orchestration</li> <li><code>docker-compose.distributed.yml</code> - 3-node Raft cluster</li> <li><code>docker-integration/docker-compose.integration.yml</code> - Integration test suite</li> <li><code>dev.sh</code> - Development helper script</li> <li><code>docker-build.sh</code> - Build orchestration script</li> </ul> <h3 id="best-practices" class="position-relative d-flex align-items-center group"> Best Practices <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"> Share link </button> </h3> <h4 id="development" class="position-relative d-flex align-items-center group"> Development <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" aria-haspopup="dialog" aria-label="Share link: Development"> Share link </button> </h4><ul> <li>Use <code>./dev.sh</code> commands for consistent environment</li> <li>Mount source code for live reloading</li> <li>Enable debug logging (<code>GEODE_LOG_LEVEL=debug</code>)</li> <li>Use named volumes for persistent data</li> </ul> <h4 id="production" class="position-relative d-flex align-items-center group"> Production <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" aria-haspopup="dialog" aria-label="Share link: Production"> Share link </button> </h4><ul> <li>Use <code>prod</code> or <code>latest</code> image tags</li> <li>Enable read-only filesystem</li> <li>Set resource limits (CPU, memory)</li> <li>Use health checks for orchestration</li> <li>Enable FIPS mode for compliance</li> <li>Run as non-root user</li> <li>Use secrets management (Vault, Docker secrets)</li> <li>Configure proper TLS certificates</li> <li>Monitor with Prometheus/Grafana</li> </ul> <h4 id="security" class="position-relative d-flex align-items-center group"> Security <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"> Share link </button> </h4><ul> <li>Always use TLS certificates in production</li> <li>Enable FIPS mode for cryptographic compliance</li> <li>Use distroless base images for minimal attack surface</li> <li>Drop unnecessary capabilities</li> <li>Run containers as non-root</li> <li>Use read-only filesystem where possible</li> <li>Scan images for vulnerabilities</li> <li>Rotate credentials regularly</li> </ul> <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/configuration/server-configuration/" >Server Configuration</a> - Detailed configuration options</li> <li><a href="/docs/ops/observability/" >Observability</a> - Monitoring and logging setup</li> <li><a href="/docs/guides/multi-datacenter/" >Multi-Datacenter Deployment</a> - Advanced distributed deployment</li> <li><a href="/docs/guides/backup-automation/" >Backup Automation</a> - S3 backup integration</li> <li><a href="/docs/security/overview/" >Security Overview</a> - Enterprise security features</li> </ul> <h3 id="resources" class="position-relative d-flex align-items-center group"> Resources <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="resources" aria-haspopup="dialog" aria-label="Share link: Resources"> Share link </button> </h3><ul> <li><a href="https://hub.docker.com/r/geodedb/geode" aria-label="Geode on Docker Hub – opens in new window" target="_blank" rel="noopener noreferrer" >Geode on Docker Hub ↗ </a> - Official Geode container images</li> <li><a href="https://docs.docker.com/compose/" aria-label="Docker Compose Documentation – opens in new window" target="_blank" rel="noopener noreferrer" >Docker Compose Documentation ↗ </a> </li> <li><a href="https://datatracker.ietf.org/doc/html/rfc9000" aria-label="QUIC Protocol – opens in new window" target="_blank" rel="noopener noreferrer" >QUIC Protocol ↗ </a> </li> </ul> <hr> License: Apache License 2.0 Copyright: 2024-2025 CodePros Last Updated: January 2026