For molecular modelers committed to precision and reproducibility, selecting the right GROMACS version can sometimes become a critical concern. Whether due to specific version requirements for legacy code or ensuring that methods align perfectly across different computational environments, having the flexibility to use custom GROMACS builds can make all the difference. Thankfully, the GROMACS Wizard within the SAMSON platform offers just this flexibility. Here, we’ll guide you through how to seamlessly integrate your custom GROMACS version for local computations within SAMSON.
Why Go Custom?
While the GROMACS Wizard in SAMSON comes equipped with a recent version of GROMACS, there might be cases where you need to use a specific version:
- To ensure compatibility with pre-existing workflows or simulations.
- For strict reproducibility in published research.
- To leverage optimizations tied to a specific system or hardware setup.
Switching to a custom GROMACS version in SAMSON is straightforward. Let’s break it down.
Enabling a Custom GROMACS Version
To begin, access the GROMACS Wizard and click on the Settings button, which can be found at the top of the interface:

Inside the Settings menu, you will find the option to Use a different GROMACS version. Enabling this option allows you to provide the following two paths:
- Path to the GROMACS executable: Browse and select the executable file on your system (
gmx.exefor Windows orgmxfor Linux and macOS). Once selected, the system will display the version of your chosen GROMACS build. If the executable is not recognized, it will indicate this with an “invalid” message. - Path to the force fields folder: Specify where your forcefield.ff folders reside. For example, on Linux and macOS, this could be $HOME/gromacs/share/top/. This folder structure helps GROMACS identify and utilize the relevant molecular force fields during simulations.
Below is an example of how the Settings interface looks after enabling a custom version and providing the required paths:

Why Is This Useful?
Setting a custom version allows you to match your local computational setup to the specific needs of your project. If, for instance, you aim to re-run simulations from an older study published with GROMACS version 5.1, you can directly load this version into SAMSON and ensure every parameter aligns perfectly.
This flexibility is particularly valuable for collaborative research teams where uniformity across different environments is crucial.
Conclusion
The ability to configure SAMSON’s GROMACS Wizard with custom versions empowers researchers with the reproducibility and precision they need in their molecular modeling endeavors. For step-by-step instructions, you can always refer to the detailed documentation provided by SAMSON: https://documentation.samson-connect.net/tutorials/gromacs-wizard/settings/.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Download SAMSON today and explore its capabilities!
