A molecular modeling workflow can stall before the science begins: the software is installed, but you are unsure whether your computer is supported, where to launch the application, or what to do after the first window opens. A short, deliberate setup check can make that first session much less frustrating.
This guide turns the SAMSON onboarding steps into a practical sequence: check compatibility, install, launch using the method for your operating system, and choose a sensible next task. It is intended for molecular modelers who want to get from setup to opening a structure without exploring every feature first.

Before installing: check the basics
Start with the requirements and platforms guide. Confirm that your operating system is supported and that your computer meets the hardware expectations. Linux users should also check the listed dependencies before starting the installer. Doing this first helps distinguish an installation problem from a compatibility or graphics setup issue.
Then follow Install SAMSON for the download and installer workflow, including the sign-in and key-entry steps. If anything goes wrong during installation or graphics setup, use the Troubleshooting guide rather than repeatedly rerunning the installer without checking the cause.
Launch it the way that fits your system
- Windows: Open the Start menu and search for SAMSON. The documented executable path is
C:/Users/%USERNAME%/OneAngstrom/SAMSON-Application/11.0.0/Binaries/SAMSON-Core.exe. - Mac: Launch SAMSON from Launchpad or the Applications folder. The documented installation location is
$HOME/Applications/SAMSON.app/. - Linux: Use the Apps dashboard, or open a terminal in the SAMSON Binaries folder and run
./SAMSON-Core.sh. The documented folder is~/OneAngstrom/SAMSON-Application/11.0.0/Binaries.
On Linux, if you want a shorter command for future sessions, the documentation shows how to add an alias named samson to ~/.bashrc or ~/.zprofile, then open a new terminal and run samson. If your installation is in a different location, use its actual path when creating the alias.
What happens after the first launch?
SAMSON has an open architecture, and its Extensions add tools such as apps, editors, controllers, models, and parsers. The first time you start the platform, it downloads a set of default Extensions from SAMSON Connect. You can later sign in, browse the Marketplace, and choose additional Extensions for your workflow. There is no need to decide on every add-on before you have started exploring.
For a low-friction first session, pick one immediate goal:
- Get oriented: open First look: the interface to learn the main areas of the interface.
- Open a structure: follow Loading molecules and focus on getting one molecular structure into a document.
- Explore the platform: use the Quick Start Guide for a compact introduction to navigation, documents, visualizations, simulations, and help routes.
Choosing one of these goals makes it easier to learn the interface in context instead of trying to understand every tool at once. If you need account, key, or Marketplace information, go to SAMSON Connect.
For the complete onboarding path and the latest setup details, learn more in the SAMSON Getting Started documentation.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.
