Vina Setup
Load receptor and ligand PDBQT files, define a docking box, inspect placement, and export a Vina-style configuration.
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.
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
| Question | Answer |
|---|---|
| Primary job | Define and export the docking search space. |
| Main risk | Incorrect grid center or dimensions. |
| Best next step | Load config, receptor, and ligand into Vina Run or an external Vina installation. |
| Reproducibility file | Config 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
- 0Ligand Draw
Create or import a ligand starting structure.
- 1Ligand Prep
Inspect ligand chemistry, metadata, and torsion restrictions.
- 2Receptor PDB Clean
Clean a receptor PDB and decide what to keep.
- 3Receptor PQR Handoff
Assign receptor protonation and charges with an external PQR workflow.
- 4PDBQT Converter
Convert cleaned receptor and prepared ligand material to docking-ready PDBQT.
- 5Vina Setup
Define the docking box and export a Vina-style configuration.
- 6Vina Run
Run or emulate docking and inspect poses, scores, and warnings.
Step-by-step use
- Load receptor PDBQT. Wait for parsing and inspect status messages. If the receptor is empty, malformed, or missing expected atoms, return to PDBQT Converter.
- 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.
- 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.
- 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.
- Set the center coordinates. The center should correspond to the intended binding pocket, reference ligand, catalytic site, interface, or search region.
- 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.
- Check padding, point counts, spacing, and size. Understand which fields control the displayed dimensions and which are exported to the configuration.
- Set Vina parameters such as exhaustiveness, number of modes, energy range, and seed if present. Record non-default values.
- 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.
- Export the configuration. Copy or download it according to the page controls. Save session JSON if you need to revisit the setup later.
- 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
- Receptor PDBQT loaded without critical warnings.
- Ligand PDBQT loaded and is the intended ligand.
- Grid visually covers the intended site.
- Box is not unnecessarily huge.
- Vina parameters are recorded.
- Config export was saved with the matching receptor and ligand files.
Troubleshooting
| Problem | What 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
- Keep the original input files unchanged. Save all exports into a project folder with a clear date and version note.
- Do not use a generated result only because the page produced it. Inspect warnings, inputs, assumptions, and output format before moving to the next step.
- For publication, reporting, or operational decisions, validate the result with established scientific software and cite the final software versions and settings.
- Treat browser storage as temporary. Export session JSON or report files whenever you need a reproducible record.
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.