Installation
Choose the installation method that best fits your environment.
- ๐ณ Docker (Recommended)
- โก Native Install
- ๐ฆ Spack
Pull and run the IOWarp Docker image:
docker pull iowarp/iowarp:latest
Run the container:
docker run -d -p 5555:5555 --shm-size=8g --ipc=shareable --name iowarp iowarp/iowarp:latest
Using Docker Composeโ
Create a docker-compose.yml:
services:
iowarp-runtime:
image: iowarp/iowarp:latest
container_name: iowarp-runtime
volumes:
- ./wrp_conf.yaml:/etc/iowarp/wrp_conf.yaml:ro
ports:
- "5555:5555"
shm_size: 8g
mem_limit: 8g
ipc: shareable
stdin_open: true
tty: true
restart: unless-stopped
Start the service:
docker-compose up -d
info
Shared memory (shm_size) and shareable IPC are required for CTE operations. See the Configuration Reference for details.
Use the standalone installer script:
curl -fsSL https://raw.githubusercontent.com/iowarp/iowarp-install/main/install.sh | bash
This will:
- Clone and build IOWarp core with all submodules
- Install the IOWarp CLIO Kit
- Set up the complete IOWarp environment
- Install Spack (v0.23 recommended):
git clone https://github.com/spack/spack.git -b v0.22.3
cd spack
. share/spack/setup-env.sh
echo ". ${PWD}/share/spack/setup-env.sh" >> ~/.bashrc
- Add the IOWarp repository:
git clone https://github.com/iowarp/iowarp-install.git
spack repo add iowarp-install/iowarp-spack
- Install IOWarp:
spack install iowarp
Next Stepsโ
- Quick Start Tutorial โ Run your first benchmark
- Configuration Reference โ Customize your deployment
- CLIO Kit โ Explore MCP servers for AI agents