simvia/code_saturne repository overview

⁠code_saturne Docker Images

This repository provides Docker images for running code_saturne⁠ in a reproducible and portable environment, including graphical access via X11 when needed.

⁠📦 Image Tag

The currently available image is:

simvia/code_saturne:9.0.0

This corresponds to the official code_saturne release 9.0.0.

⁠🚀 How to Run the Image

⁠Command-line usage (headless)

The container runs the code_saturne command directly via its entrypoint.

To run it in command-line mode:

docker run --rm \
  --mount type=bind,source=$(pwd),target=/home/code_saturne \
  simvia/code_saturne:9.0.0

This assumes your current directory contains a valid case, which will be mounted at /home/code_saturne inside the container.

⁠🖥️ Graphical interface (GUI mode)

To open the code_saturne GUI via X11, pass the gui argument and enable X11 forwarding:

docker run --rm \
  --mount type=bind,source=$(pwd),target=/home/code_saturne \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -e DISPLAY=unix$DISPLAY \
  simvia/code_saturne:9.0.0 gui

⁠Optional: Create a shortcut alias

You can define an alias to simplify launching the GUI:

alias code_saturne='docker run --rm \
  --mount type=bind,source=$(pwd),target=/home/code_saturne \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -e DISPLAY=unix$DISPLAY \
  simvia/code_saturne:9.0.0'

Then just run:

code_saturne gui

📌 Make sure X11 connections are allowed on your host (xhost +local: may be required).

⁠🛠️ Inside the Container

• Working directory: /home/code_saturne (bound to your local folder)
• To launch the GUI:

code_saturne gui

• To execute command-line actions:

code_saturne run

Other subcommands (create, info, etc.) are also available.

⁠📄 Notes

• The container runs as a non-root user by default.
• All outputs (logs, meshes, results) are written to your local directory.

⁠🧰 Maintainer

These images are maintained by the Simvia⁠ team!