Installing molecular modeling software is only one part of getting started. The more frustrating moment can come afterward: the application is installed, but you are not sure whether your computer meets the requirements, where to launch it, or what to do once it opens. A short, deliberate first-launch routine can make those decisions easier.
This guide follows the setup path for SAMSON, an integrative platform for computational nanoscience. It is designed to help you move from checking your system to choosing a useful next step—without treating installation, interface orientation, and opening a structure as the same task.

Before opening the application
Start by checking the system requirements and supported platforms. This is especially useful on Linux, where the guide also covers dependencies, and when you need to verify hardware expectations before troubleshooting an installation.
Then follow the installation instructions for the installer workflow, sign-in, and key entry. If something goes wrong, consult Troubleshooting rather than repeatedly retrying the same step. SAMSON’s current public version is 2026 R1; the versioning guide explains how version numbers are used.
Find the right launch route
The way you start SAMSON depends on your operating system:
- Windows: Search for SAMSON in the Start menu. The executable is listed in the installation folder at
C:/Users/%USERNAME%/OneAngstrom/SAMSON-Application/11.0.0/Binaries/SAMSON-Core.exe. - Mac: Open SAMSON from Launchpad or the Applications folder. The documented location is
$HOME/Applications/SAMSON.app/. - Linux: Open it from the Apps dashboard, or run
./SAMSON-Core.shfrom the Binaries folder in the installation directory. If you want a terminal shortcut, the documentation shows how to create an alias in~/.bashrcor~/.zprofile, then launch it by enteringsamsonin a new terminal.
On Linux, if you encounter a graphics issue with an AMD/ATI card, use the specific Linux AMD troubleshooting guidance. For other setup problems, the broader troubleshooting page is a sensible next stop.
Choose one next step—not all of them
After the application opens, decide what you came to do. If you want to understand the interface first, read First look: the interface. If you already have a structure and want to open it, go to Loading molecules. For a compact tour that covers interface, navigation, documents, visualizations, simulations, and help routes, use the Quick Start Guide; a downloadable PDF is available on that page.
This distinction helps prevent a common onboarding detour: searching for a way to load a molecule when what you need is interface orientation, or exploring account settings when you simply want to begin with a structure.
Understand extensions before customizing
SAMSON has an open architecture that can be adapted with extensions, including 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 extensions for your workflow. There is no need to investigate extension management before you have a task in mind; when you are ready, the Extending SAMSON guide covers managing extensions and the SDK path.
A simple sequence keeps the first session manageable: verify requirements, install, launch using your operating system’s route, then choose either interface orientation or molecule loading. For the full onboarding page and its links to each step, learn more in Getting Started.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.
