Molecular modeling often requires high precision and reproducibility. However, dealing with complex systems, researchers frequently encounter the limitation of pre-configured tools that may not fully align with their individual requirements. If you’re using GROMACS on SAMSON’s GROMACS Wizard and need to run simulations locally with a specific GROMACS version or custom performance parameters, there’s a built-in feature that can solve this challenge and ensure optimal performance.
Why Customize Your GROMACS Version?
The GROMACS Wizard in SAMSON includes a packaged version of GROMACS by default. While this is a fast and handy way to get started, many users find themselves in situations where the built-in setup isn’t suitable. Reasons may include:
- Wanting reproducible results with a specific GROMACS version.
- Using system-specific hardware configurations for performance optimization.
- Integrating custom force fields stored on your machine.
If any of these apply to you, switching to a local version of GROMACS is straightforward and can offer enhanced control over your simulations.
Step-by-Step: Configuring a Custom GROMACS Version
Here’s how to set up and use your own locally installed GROMACS version with the GROMACS Wizard:
- Open the GROMACS Wizard in SAMSON and click the Settings button at the top.
- Under the options, enable the checkbox labeled Use a different GROMACS version.
- Provide the following paths:
- The path to the local GROMACS executable (e.g.,
gmx.exefor Windows orgmxfor Linux/macOS) by clicking on the browse button
. - The path to your force field directory (e.g., $HOME/gromacs/share/top/ on Linux/macOS), which contains all forcefield.ff directories.
- The path to the local GROMACS executable (e.g.,
Once completed, the Wizard will display the version of the executable you’ve selected. If the setup is incorrect, such as an invalid path, the Wizard will notify you to make adjustments.

Fine-Tuning Performance Parameters
After selecting your desired GROMACS version, you can further optimize your simulation by specifying local performance parameters. By default, the GROMACS Wizard ensures your system remains responsive by limiting the number of threads used. However, advanced users may want to adjust this and other aspects, like:
ntmpi: Number of MPI threads for domain decomposition.ntomp: Number of OpenMP threads for thread parallelization.pme: Controls PME (particle-mesh Ewald) algorithm strategies.maxh: Maximum wall clock time for the job.
You can configure these options in the Settings menu to suit your requirements, taking full advantage of GROMACS’s built-in parallelization intelligence. Familiarize yourself with additional parameters using the GROMACS Manual.

The Benefits of Customization
Customizing your GROMACS environment ensures greater synchrony between your computational setup and your research needs. Whether you’re striving for reproducibility or optimizing local hardware utilization, these personalization options save time and improve outcomes.
Ready to try this out? Learn more on SAMSON’s official documentation page: https://documentation.samson-connect.net/tutorials/gromacs-wizard/settings/
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Don’t have SAMSON yet? Download it now at https://www.samson-connect.net.
