diff --git a/doc/source/cluster/vms/user-guides/community/slurm.rst b/doc/source/cluster/vms/user-guides/community/slurm.rst index 2a02aed01d66..12b04321fc59 100644 --- a/doc/source/cluster/vms/user-guides/community/slurm.rst +++ b/doc/source/cluster/vms/user-guides/community/slurm.rst @@ -262,3 +262,20 @@ Here are some community-contributed templates for using SLURM with Ray: .. _`YASPI`: https://github.com/albanie/yaspi .. _`Convenient python interface`: https://github.com/pengzhenghao/use-ray-with-slurm + + +Troubleshooting +--------------- + +.. _ray-slurm-docker-init: + +Zombie processes in Docker containers +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Running Ray on Slurm inside a Docker container can produce zombie processes. See `this comment +`_ for details. + +Two recommended fixes: + +1. Use ``docker run --init`` (`Docker CLI docs `_). +2. Set ``init: true`` in ``docker-compose.yaml`` (`Docker Compose docs `_).