Installing the software
Which installer to choose, what the software needs, what is placed on disk, how GeinDFT and updates arrive, and how to confirm afterwards that everything is working.
GeinDock Suite ships as an installer for Windows and as a self contained AppImage for Linux. Both carry everything the application needs, including the structure preparation toolkit, the docking backend and the chemistry libraries, so there is nothing else to download and no scripting environment to configure.
Choosing a Windows installer
Version 3.2 brings GeinDFT into the suite. GeinDFT is a companion application for density functional theory and molecular visualisation. It lives in its own folder with its own entry in the Windows list of installed applications, and it runs on the GeinDock Suite licence, so there is no second key to enter. Because of that there are three installers, and which one you want depends on what is already on the machine.
| Installer | What it installs | When to use it |
|---|---|---|
GeinDock_Suite_v3.2.0.0_Setup.exe | GeinDock Suite alone. | You only need docking, or you would rather decide about GeinDFT later. It can be added from inside the application at any time. |
GeinDock_Suite_GeinDFT_v3.2.0.0_Setup.exe | GeinDock Suite and GeinDFT in one pass, each in its own folder. | A new machine on which you want both. It will not run while either application is open, and it never replaces a newer GeinDFT with the older copy it carries. |
GeinDFT_v<version>_Setup.exe | GeinDFT alone. | GeinDock Suite is already installed and you want to add or repair GeinDFT by hand. GeinDFT reads its licence through GeinDock Suite, so it does not start on a machine that has no GeinDock Suite. |
What you need
| Windows | Linux | |
|---|---|---|
| Operating system | Windows 10 version 1809 or later, or Windows 11, 64 bit | A 64 bit distribution with glibc 2.31 or later |
| Processor | Any 64 bit x86 processor. Docking scales with core count, so more cores finish a batch sooner. | Same |
| Memory | 8 GB is comfortable for a single receptor. Allow 16 GB for large batches. | Same |
| Graphics | OpenGL 3.3. Any adapter from the last decade qualifies, including integrated ones. | Same, with a working Mesa or vendor driver |
| Disk | About 2 GB for the application. Projects grow with the number of poses you keep. | Same |
| Display | 1366 by 768 or larger. The layout has been checked from that size up to 8K. | Same |
Installing on Windows
- Run the installer. Double click the setup file you were sent. Windows may ask you to confirm that you want to allow it to make changes; this is the standard prompt for any application that writes to Program Files.
- Choose an install location. The default is
C:\Program Files\GeinDock Suite. Accept it unless you have a reason not to. Folder names that contain accented or other non Latin characters are handled, both here and for your project folders. - Choose the shortcuts. Create a desktop shortcut and Create a Start Menu entry are both ticked to begin with. With the combined installer the same two choices apply to GeinDFT.
- Let it finish, then start the application. The first start takes a few seconds longer than later ones while the graphics pipeline is compiled.
Upgrading from an earlier version
Run the new installer over the old one. It finds the existing installation, proposes the same folder so that your shortcuts keep working, and removes program files that the new version no longer uses. This also applies if you are coming from the earlier generation of GeinDock Suite (the 2.5 series): the installer removes that version for you and puts version 3.2 in its place. In every case your licence activation is kept, so you are not asked to activate again.
Installing without the wizard
If you look after several machines, the installer can be run from a command prompt or a deployment tool. All three installers accept the same switches.
| Switch | What it does | When to use it |
|---|---|---|
/SILENT | Installs with the default choices and shows no wizard. | Unattended roll out to many machines. Start it from an administrator session. |
/DIR="C:\path" | Installs into the folder you name. | Your site keeps applications somewhere other than Program Files. |
/NOICONS | Creates no shortcuts. | Shared or managed desktops where shortcuts are published centrally. |
/LOG=file.txt | Writes a transcript of every step to the file you name. | Always worth adding to a silent install, because there is no window to report a problem. |
Removing the software
Use the Windows list of installed applications, or Uninstall GeinDock Suite in the Start menu. The uninstaller removes what the installer placed and leaves alone any file of your own that happens to sit in the install folder. It also leaves your licence activation in place, so removing the application to fix a problem and installing it again does not use up another activation. GeinDFT has its own uninstaller, and removing either application never affects the other.
Adding GeinDFT later
If GeinDFT is not on the machine, GeinDock Suite asks once, shortly after version 3.2 first starts, whether you would like it. The question arrives in a box titled GeinDFT with the download size. Yes downloads the combined installer, closes GeinDock Suite while it runs and opens it again afterwards, keeping your licence, settings and projects. No is remembered, and the question is not put at start-up again. Nothing is asked when the machine is offline; the question simply waits for a later start.
Whatever you answered, Tools › Get GeinDFT makes the same offer whenever you want it. Once GeinDFT is installed that entry is replaced by Tools › Open GeinDFT, which starts it.
Updates
Each time it starts, GeinDock Suite checks quietly whether a newer release has been published. If you are up to date, or the machine has no internet connection, it says nothing and you carry on working. When a release is available an Update Available box names the new version, the one you have, and the size of the download.
| Button | What it does | When to choose it |
|---|---|---|
| Update Now | Downloads the new version, installs it and opens the application again. | The usual choice. Save your project first, because the application closes while the update is installed. |
| Later | Closes the box and changes nothing. The offer returns at the next start. | You are in the middle of a study and want to finish it on the version you began with. |
| Update and add GeinDFT | Updates GeinDock Suite and installs GeinDFT beside it. Shown in place of Update Now while GeinDFT is not installed. | You want GeinDFT and have not installed it yet. |
| Update GeinDock Suite only | Updates GeinDock Suite and leaves GeinDFT out. Shown alongside the button above. | You do not need GeinDFT. Choosing this also stops the start-up question about GeinDFT from being asked again. |
The download shows its progress and can be cancelled. When it is complete the file is verified against the published release, and a download that fails that check is discarded and never run. You are then asked to confirm, the application closes, the update installs without further questions, and GeinDock Suite opens again on the new version. Your licence, settings and projects are untouched.
Help › Check for Updates runs the same check whenever you ask. Unlike the check at start-up it always answers: it tells you that you already have the latest version, or that the check could not be made because there is no connection.
Installing on Linux
The Linux build is an AppImage, which is a single executable file that needs no installation and no root access. Download it, make it executable, and run it.
chmod +x GeinDock-Suite-3.0.0-x86_64.AppImage
./GeinDock-Suite-3.0.0-x86_64.AppImage
If you would like the application to appear in your desktop menu alongside everything else, move
the AppImage somewhere permanent, such as ~/Applications, and integrate it with whatever
AppImage helper your distribution provides.
What the installer places on disk
| Location | What lives there |
|---|---|
| The install folder | The application executable, the libraries it renders with, the icon and theme resources, and the runtime folder that holds the preparation toolkit and the docking backend. |
runtime/backend | The chemistry toolchain, the structure preparation scripts and the docking executables. Everything here is bundled and versioned with the application, so a run on your machine and a run on a colleague's machine use the same tools. |
resources/examples | A small example structure you can open to check that the viewer works before you commit to a real study. |
| Your projects folder | Wherever you save a project. Each project keeps its own workspace beside it, holding the prepared receptor, the prepared ligands and the raw output of every run, so a project folder is self contained and can be archived or handed on. |
Checking that the installation is sound
Start the application and look at the status bar along the bottom of the window. It carries four indicators, Receptor, Ligand, Grid and a readiness word. On a fresh start the first three are unticked and the last reads Ready, which means the backend answered when the application asked it to.
For a fuller check, open Help › About GeinDock Suite. The About box reports the version and the build it came from, which is what to quote if you ever need to report a problem.