Deployment

Deployment

Production deployment options for MindFry.

Docker (Recommended)

docker run -d \
  --name mindfry \
  -p 9527:9527 \
  -v mindfry-data:/data \
  ghcr.io/laphilosophia/mindfry:latest

Docker Compose

version: '3.8'
services:
  mindfry:
    image: ghcr.io/laphilosophia/mindfry:latest
    ports:
      - '9527:9527'
    volumes:
      - mindfry-data:/data
    environment:
      - MINDFRY_LOG_LEVEL=info
    restart: unless-stopped

volumes:
  mindfry-data:

Binary Installation

Download from GitHub Releases and run directly.

Linux

curl -LO https://github.com/laphilosophia/mindfry/releases/latest/download/mindfry-linux-amd64
chmod +x mindfry-linux-amd64
./mindfry-linux-amd64

macOS

curl -LO https://github.com/laphilosophia/mindfry/releases/latest/download/mindfry-darwin-amd64
chmod +x mindfry-darwin-amd64
./mindfry-darwin-amd64

Windows

Invoke-WebRequest -Uri "https://github.com/laphilosophia/mindfry/releases/latest/download/mindfry-windows-amd64.exe" -OutFile "mindfry.exe"
.\mindfry.exe

From Source

git clone https://github.com/laphilosophia/mindfry.git
cd mindfry
cargo build --release
./target/release/mindfry-server

Resource Requirements

Workload	RAM	CPU	Storage
Development	256MB	1 core	100MB
Small (10K lineages)	512MB	2 cores	500MB
Medium (100K lineages)	2GB	4 cores	2GB
Large (1M lineages)	8GB	8 cores	10GB

Zero-GC Advantage

MindFry’s zero-GC architecture means RAM usage is predictable and stable. No GC pauses, no memory spikes.

Persistence

Data is stored in /data directory (configurable):

/data/
├── akashic/          # sled database
├── snapshots/        # Named checkpoints
└── wal/              # Write-ahead log

Mount a volume to persist across restarts.