Skip to content

Docker Build Guide

[!NOTE] For the latest implementation status, please refer to Functional Implementation Status (Remaining Functionality).

This guide summarizes the main Docker build and startup patterns for EvoSpikeNet-Core.

Scope

  • Unified Compose stack: docker-compose.yml
  • NGC GPU stack: docker-compose.ngc.yml
  • RAG standalone stack: rag-system/docker-compose.yml
  • RAG backend-only stack: rag-system/backend/docker-compose.yml

Prerequisites

  • Docker Engine
  • docker compose v2
  • NVIDIA Container Toolkit when using GPU

Verification commands:

docker --version
docker compose version

Important Build Variables

The root Dockerfile primarily uses these build args:

  • BUILD_TARGET: usually development
  • ENABLE_GPU: true or false
  • INSTALL_JUPYTER: whether to include Jupyter in notebook-oriented images

For NGC-based builds, this is additionally used:

  • NGC_PYTORCH_TAG: e.g. 26.01-py3

About Environment Files

This repository ships .env.example. For initial setup:

cp .env.example .env

Minimal CPU example:

```bash cat > .env <<'EOF' BUILD_TARGET=development ENABLE_GPU=false EVOSPIKENET_API_KEY=test-api-key EVOSPIKENET_API_KEYS=test-api-key EVOSPIKENET_ALLOW_NO_AUTH=true