The simulation-platform repository contains documentation on how to setup and manage a simulation cluster on your cloud provider.
The simulation cluster provides capability to run large scale simulations on cloud infrastructure using a Kubernetes® cluster and cloud-native components. Once the cluster is setup, then users can submit sim jobs to the cluster using the Large-scale cloud simulation for Simulink® support package for the MATLAB® software as a client.
Using your cloud-provider account, the simulation cluster provisions a group of cloud resources, open-source components and default configuration to stand up the necessary infrastructure.
mwcsim is a command line tool to easily manage simulation clusters on a cloud provider. It provides convenience functionality to create, delete and manage a cluster. Advanced users are encouraged to modify the Terraform® file and Kubernetes manifests underlying the cluster and apply them to get the customized cluster you need, especially for massive simulation needs or custom integration requirements with existing systems.
The easiest method is to pull the csim-mwcsim container, which brings all the configuration files along with the CLI.
docker pull containers.mathworks.com/simulation-platform/csim-mwcsim:v1.1.26
Install the CLI with the following commands. The install.sh command may prompt for sudo access. Use absolute paths to run the installation smoothly.
mkdir -p $HOME/.mwcsim
docker run --mount type=bind,source=$HOME/.mwcsim,target=/mount containers.mathworks.com/simulation-platform/csim-mwcsim:v1.1.26
$HOME/.mwcsim/install.sh
This installs the CLI into /usr/local/bin and the configuration files to $HOME/.mwcsim, which is the default working directory of mwcsim. You can test the installation by checking the version.
mwcsim version
This section outlines quick introductory setups to get a local cluster ready. More detailed documentation for advanced setups are available.
For all commands below, my-cluster is a placeholder that should be replaced by your desired name. If you encounter any issues, please check the known-issues page as well.
To run this introductory workflow, you need at least:
- Linux machine with x86_64 architecture and at least 12GB of RAM, 40GB of disk space
- sudo access
- MATLAB installed with Simulink Compiler license
- docker engine
Create a local cluster.
mwcsim create cluster my-cluster
Get the cluster endpoint and note this down.
mwcsim get cluster my-cluster
Install the support package on the MATLAB client.
Once the cluster is ready, use the MATLAB client documentation to send simulation jobs to the cluster using the cluster endpoint. For the local cluster set up above, the MATLAB client must be running on the same machine.
- Local cluster setup
- AWS cluster setup
- Manual domain provisioning for cloud clusters
- Advanced configuration of manifests and terraform files
- mwcsim usage manual
- mwcsim command reference
- Known issues
Known issues and troubleshooting details can be found here.
To notify of bugs or request additional features, please create an issue on this repository or contact your account manager.
If you require active assistance, contact MathWorks Technical Support.
MATHWORKS CLOUD REFERENCE ARCHITECTURE LICENSE © 2026 The MathWorks, Inc.