Skip to content
GSI-HPCPublic

Repository files navigation

sind — Slurm in Docker

Create and manage containerized Slurm clusters for development, testing, and CI/CD workflows.

🚀 Getting Started    📖 Documentation

Watch a tour of sind: the CLI and the web UI, recorded from real runs


Inspired by kind (Kubernetes in Docker), sind offers a familiar CLI experience for quickly spinning up and tearing down Slurm clusters.

Features

  • Multi-node, multi-cluster & multi-realm — run controller, database, REST API, submitter, and worker nodes side by side, or spin up multiple clusters across isolated realms with shared networking
  • System containers — full systemd-based nodes that emulate bare metal, compatible with Ansible, Chef, and other config management tools; unmanaged clusters leave Slurm itself to them
  • Designed for CI/CD — runs on standard GitHub Actions runners with the runner's Docker daemon, no privileged containers; sind-action sets up clusters in a single step
  • Multiple Slurm versions — official node images for the supported Slurm release lines (26.05 and 25.11) on linux/amd64 and linux/arm64, each with a full MPI stack, or bring your own image
  • Job accounting, users and identity — a db node runs MariaDB and slurmdbd; users, groups and Slurm accounts with limits, and identity modes from local accounts to nss_slurm and auth/slurm
  • REST API — slurmrestd on an api node with JWT authentication (Slurm 26.05)
  • CVMFS — mount /cvmfs read-only on every node, from the Docker host or a volume plugin
  • Monitoring — an opt-in Prometheus, Loki and Grafana stack per realm collects Slurm's metrics, the nodes' resource use and their journals, with dashboards for clusters, nodes, services, users and logs (Slurm 26.05)
  • Web UI — sind ui shows realms, clusters, nodes and runs live in your browser, says what needs a look and which fix to try first, and shows the exact sind command before it runs one
  • Connect outside containers — attach containers such as kind nodes to a realm's mesh and cluster networks
  • Worker lifecycle — dynamically add and remove worker nodes from running clusters
  • Power cycle simulation — shutdown, reboot, freeze, and power-cycle nodes to simulate real-world failure scenarios
  • Minimal dependencies — just Docker Engine on a Linux host and a sind container image; usable as both a CLI tool and a Go library
  • AI-ready via MCP — built-in MCP server lets AI assistants manage your Slurm clusters

Quick start

With Docker 28 or later on a Linux host with cgroup v2:

curl -fLo sind https://github.com/GSI-HPC/sind/releases/latest/download/sind-linux-amd64
sudo install sind /usr/local/bin/sind
mkdir sind-demo && cd sind-demo
sind create cluster && sind exec -- sinfo

Every node mounts the working directory as /data, so start in a scratch directory like this one.

See the installation guide to verify the download or install on ARM64, and sind doctor to check the host.

AI disclosure

This project is developed with the help of AI coding tools. Since September 2026, changes written by Anthropic's Claude Code agent are committed as Claude <noreply@anthropic.com> and/or carry a Co-Authored-By: Claude … trailer; earlier AI-assisted commits are not individually marked.

License

sind is licensed under the GNU Lesser General Public License v3.0.

Copyright © GSI Helmholtzzentrum für Schwerionenforschung GmbH

Releases

Used by

Contributors

Languages