Vina Setup

Docking box and configuration documentation

Load receptor and ligand PDBQT files, define a docking box, inspect placement, and export a Vina-style configuration.

Step-by-step documentationLocal browser fileVersion 0.14.4-alpha

How to cite this tool

Use this citation text and add the date accessed if the file is hosted online or shared through a repository.

Weiss AKH. Vina Setup. akhw.at local browser tools, version 0.14.4-alpha, build 2026-06-12-tools5. PHP documentation: docs/vina-setup.php.

What this page is supposed to do

This page translates prepared docking inputs into a search-space definition. Its most important job is making the grid box explicit and visually checkable before any docking run is attempted.

Use this page when

  • You have receptor and ligand PDBQT files.
  • You need to define grid center, size, spacing, and Vina parameters.
  • You want to export a Vina configuration and project session.

Do not use it as

  • Do not choose a box that excludes the intended binding site.
  • Do not use a huge box only to avoid thinking about the binding site. It can make search less meaningful.
  • Do not assume center-on-ligand is correct unless the ligand is a valid reference for the target site.

At a glance

QuestionAnswer
Primary jobDefine and export the docking search space.
Main riskIncorrect grid center or dimensions.
Best next stepLoad config, receptor, and ligand into Vina Run or an external Vina installation.
Reproducibility fileConfig text plus session JSON and notes about how the box was chosen.

Typical inputs

  • Receptor PDBQT.
  • Ligand PDBQT or ligand geometry.
  • Optional session JSON.
  • Docking-box center, dimensions, spacing, and Vina parameters.

Typical outputs

  • Vina-style configuration text.
  • Session JSON.
  • Visual confirmation of receptor, ligand, and box placement.

Where it fits in the docking workflow

  1. 0
    Ligand Draw

    Create or import a ligand starting structure.

  2. 1
    Ligand Prep

    Inspect ligand chemistry, metadata, and torsion restrictions.

  3. 2
    Receptor PDB Clean

    Clean a receptor PDB and decide what to keep.

  4. 3
    Receptor PQR Handoff

    Assign receptor protonation and charges with an external PQR workflow.

  5. 4
    PDBQT Converter

    Convert cleaned receptor and prepared ligand material to docking-ready PDBQT.

  6. 5
    Vina Setup

    Define the docking box and export a Vina-style configuration.

  7. 6
    Vina Run

    Run or emulate docking and inspect poses, scores, and warnings.

Step-by-step use

  1. Load receptor PDBQT. Wait for parsing and inspect status messages. If the receptor is empty, malformed, or missing expected atoms, return to PDBQT Converter.
  2. Load ligand PDBQT. Confirm that it appears in the expected region if it is a reference or prepared ligand. If the ligand is not meant to represent the binding site, do not use it blindly to center the grid.
  3. Fit or reset the view. Turn receptor, ligand, and box display on or off as needed. Use the 3D view to orient yourself before changing numerical parameters.
  4. Choose the grid strategy. You can suggest a box from receptor geometry, center the ligand in the grid, center the grid on a picked position, or manually enter center and size values.
  5. Set the center coordinates. The center should correspond to the intended binding pocket, reference ligand, catalytic site, interface, or search region.
  6. Set box dimensions. The box should cover the relevant pocket and ligand movement space. A box that is too small excludes poses. A box that is too large makes search and interpretation weaker.
  7. Check padding, point counts, spacing, and size. Understand which fields control the displayed dimensions and which are exported to the configuration.
  8. Set Vina parameters such as exhaustiveness, number of modes, energy range, and seed if present. Record non-default values.
  9. Import existing config text only if you know it matches the loaded receptor and ligand. After import, visually verify the box instead of trusting the text.
  10. Export the configuration. Copy or download it according to the page controls. Save session JSON if you need to revisit the setup later.
  11. Before docking, reload or reopen the exported config once if possible and confirm it reproduces the intended center and size.

How to interpret what you see

Grid center
The central coordinate of the docking search space.
Grid size
The physical box dimensions around the center.
Spacing and points
A grid representation detail. Check how the page translates them to size values.
Exhaustiveness
A search effort parameter. Higher values can increase cost and may improve exploration, but do not guarantee correctness.
Seed
A reproducibility control for stochastic components where supported.
Config text
The handoff file for the docking engine. It should be stored with receptor and ligand PDBQT files.

Quality-control checklist before moving on

Troubleshooting

ProblemWhat to check
Box appears far from receptor.Check center coordinates, unit assumptions, imported config, and whether the correct receptor file is loaded.
Ligand is not visible.Toggle ligand display, fit view, and confirm that the ligand PDBQT contains atoms.
Exported config has unexpected values.Check whether you changed points, spacing, size, or center fields after import.
Docking later explores the wrong region.Return to this page, load the exact files and config, and visually inspect grid placement.
The page opens but looks unstyled.The documentation expects the package assets folder at ../assets. If you copied only the docs folder, place it back inside the full tools directory.
Special characters display as garbled text.Serve the page as UTF-8 and keep the PHP header at the top of the file. Do not resave the file in a legacy encoding.
A button does nothing.Check whether a file must be loaded first, whether the browser blocked a popup, or whether a required external service is offline.
The output seems scientifically wrong.Stop the workflow. Check the input format, warnings, protonation state, atom typing, grid placement, and whether the tool is only a helper for that step.

Practical notes

Copyright and disclaimer

Copyright © 2026 Alexander Weiss, akhw.at. All rights reserved.

Research workflow helper only. Docking-box placement and Vina-style parameters must be reviewed scientifically. Visual agreement with a box does not prove that the docking experiment is valid.