Supported OS

We have tested Xmipp compilation on the following operating systems: - Ubuntu 18.04 - Ubuntu 20.04 - Ubuntu 22.04 - Centos 7 Visit the OS wiki page for more details.

While compilation and execution might be possible on other systems, it might not be straightforward. If you encounter a problem, please refer to known and fixed issues. Let us know if something is not working.

Hardware requirements

At least 2 processors are required to run Xmipp. In some virtual machine tools only one is assigned, please check that at least two processors are assigned to the virtual machine.

Software dependencies


Xmipp requires a C++17 compatible compiler. We recommend GCC with G++; we have good experience with GCC/G++-8.4; in any case, a version >= 8.4 is required. If you use GCC/G++-10.3 and CUDA=11 and experience issues, please change the compiler version. If you use GCC-11 and experience issues, please visit this. For more details about the compilation process and installation of gcc, please visit compiler.


Xmipp requires Cmake 3.16 or above. To update it, please visit.


Xmipp supports Cuda 8 through 12.2. CUDA is optional but highly recommended. We recommend you to use the newest version available for your operating system; though Cuda 10.2 has the widest support among other Scipion plugins. Pay attention to the compiler - CUDA compatibility.

To install CUDA for your operating system, follow the official install guide.


CUDA 11.5 is not compatible with GCC - 9, please change one of these.


OpenCV is used for some programs: movie_optical_alignment (with GPU support) and volume_homogenizer; however, it is not required. If you installed OpenCV via apt (sudo apt install libopencv-dev), it should be automatically picked up by the Xmipp script.


We sometimes see issues regarding the HDF5 dependency. Please visit the HDF5 Troubleshooting wiki.

Full list of dependencies

Before installing Xmipp, you need to ensure that your system meets certain requirements. Here are the necessary packages and dependencies:

  • libfftw3-dev: FFTW3 library development files.

  • libopenmpi-dev: OpenMPI development files.

  • libhdf5-dev: HDF5 library development files.

  • python3-numpy: NumPy library for Python 3.

  • python3-dev: Python 3 development headers.

  • libtiff5-dev: LibTIFF development files.

  • libsqlite3-dev: SQLite3 development files.

  • default-jdk: Default Java Development Kit.

  • git: Version control system for source code management.

  • cmake: Cross-platform build system.

  • libjpeg-dev: Compress, decompress, transform JPEG images.

You can install these packages on Ubuntu-based systems using the following command:

sudo apt install -y libfftw3-dev libopenmpi-dev libhdf5-dev python3-numpy python3-dev libtiff5-dev libsqlite3-dev default-jdk git cmake libjpeg-dev

Additionally, you need to install scons in the environment where Xmipp will be compiled. If you plan to run Xmipp within Scipion, you should install it in your Scipion3 environment. You can install scons using pip:

pip install scons

Finally, make sure to have a compatible compiler installed. You can install GCC 8 and G++ 8 using the following command:

sudo apt install gcc-8 g++-8

These requirements will ensure that your system is ready for installing and using Xmipp.