GeinDock Suite
Home › Installing the software

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.exeGeinDock 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.exeGeinDock 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.exeGeinDFT 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 systemWindows 10 version 1809 or later, or Windows 11, 64 bitA 64 bit distribution with glibc 2.31 or later
ProcessorAny 64 bit x86 processor. Docking scales with core count, so more cores finish a batch sooner.Same
Memory8 GB is comfortable for a single receptor. Allow 16 GB for large batches.Same
GraphicsOpenGL 3.3. Any adapter from the last decade qualifies, including integrated ones.Same, with a working Mesa or vendor driver
DiskAbout 2 GB for the application. Projects grow with the number of poses you keep.Same
Display1366 by 768 or larger. The layout has been checked from that size up to 8K.Same

Installing on Windows

  1. 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.
  2. 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.
  3. 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.
  4. Let it finish, then start the application. The first start takes a few seconds longer than later ones while the graphics pipeline is compiled.
The installer needs administrator rights. It installs the application for everyone who logs in to the machine, so Windows asks for an administrator's approval wherever you choose to put it. If your account cannot give that approval, ask whoever manages the computer to run the installer for you. Your licence and your projects still belong to your own account.

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
/SILENTInstalls 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.
/NOICONSCreates no shortcuts.Shared or managed desktops where shortcuts are published centrally.
/LOG=file.txtWrites 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 NowDownloads 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.
LaterCloses 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 GeinDFTUpdates 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 onlyUpdates 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.

GeinDFT looks after its own updates. GeinDock Suite only ever checks for GeinDock Suite. Once GeinDFT is installed, update it from the Help menu of GeinDFT itself.

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 folderThe 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/backendThe 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/examplesA small example structure you can open to check that the viewer works before you commit to a real study.
Your projects folderWherever 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.

Antivirus software and the docking backend. The backend runs as a short lived separate process for every preparation and every docking job. Some endpoint protection products treat a burst of new processes as suspicious and either slow them down or block them outright, which shows up as a job that never starts or one that fails immediately. If you see that, add the install folder to your protection product's exclusion list.