Skip to main content

​
Distributed Deployment

Memorose supports replicated deployment with Raft and can be started locally in clustered form through the project scripts. 
./scripts/start_cluster.sh start --clean --build
Typical local shape:
  • backend nodes on 3000, 3001, 3002
  • dashboard UI on 3100

​
Cluster Management Endpoints

  • POST /v1/cluster/initialize
  • POST /v1/cluster/join
  • DELETE /v1/cluster/nodes/:node_id

​
Join Payload

{
  "node_id": 2,
  "address": "127.0.0.1:5002"
}

​
Example Initialization

curl -s -X POST http://127.0.0.1:3000/v1/cluster/initialize \
  -H "Authorization: Bearer $TOKEN"

​
Example Join

curl -s -X POST http://127.0.0.1:3000/v1/cluster/join \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "node_id": 2,
    "address": "127.0.0.1:5002"
  }'

​
Operational Notes

  • In single-node mode, join and leave operate on the local raft group.
  • In sharded mode, cluster operations fan out across shard groups.
  • Leader forwarding is built into write paths, but operational cluster control still expects a healthy Raft topology.