Requirements
Supported OS
Xmipp has been tested on the following operating systems:
Ubuntu: 18.04, 20.04, 22.04, 24.04
CentOS: 7
Other Linux systems may work but are not officially supported. Compilation and execution might not be straightforward.
Hardware requirements
At least 2 CPU cores are required.
On some virtual machine tools only one is assigned by default. Please check and ensure at least two processors are assigned.
Software dependencies
Compiler
Xmipp requires a C++17 compatible compiler.
Compiler |
Minimum Version |
---|---|
GCC |
8.4 |
Clang |
5.0 |
Note
Clang is mostly untested. If compiling with CUDA, a compatible compiler must be available.
CMake
Xmipp requires CMake >= 3.18 and < 4.
CUDA (optional)
CUDA is optional but highly recommended. By default, Xmipp will search for your CUDA installation.
Supported versions: 10.2 – 12.6
We recommend using the newest version available for your operating system.
Installation guide: CUDA Toolkit Archive
Warning
CUDA 11.5 is not compatible with GCC 9. Please change one of them if you encounter errors.
Dependencies
The following packages must be installed before building Xmipp:
gcc
,g++
— C and C++ compilerscmake (>=3.18,<4)
— cross-platform build systemgit
— version control systemzlib
— compression libraryfftw (>=3)
— FFT libraryhdf5 (>=1.18)
— HDF5 libraryopenmpi
development librariessqlite (>=3)
— SQLite databaselibtiff
— TIFF image supportlibjpeg
— JPEG support (Ubuntu:libjpeg-dev
/ RHEL:libjpeg-turbo-devel
)openjdk (>=11)
— Java Development Kitpython3-dev
andpython3-numpy
— Python 3 development headers and NumPy
Installing dependencies
Ubuntu/Debian
sudo apt install -y gcc g++ cmake git libfftw3-dev libopenmpi-dev libhdf5-dev libtiff5-dev libsqlite3-dev libjpeg-dev python3-dev python3-numpy default-jdk zlib1g-dev
CentOS/RHEL
Note
On CentOS 7, the default GCC version is not compatible with Xmipp. You can enable a newer GCC version with:
yum install centos-release-scl
yum install devtoolset-10
scl enable devtoolset-10 bash
Note
On some RHEL-based systems, HDF5 may require enabling the EPEL repository:
yum install epel-release
Install dependencies with:
yum install -y gcc gcc-c++ cmake git fftw-devel openmpi-devel hdf5-devel libtiff-devel sqlite-devel libjpeg-turbo-devel python3-devel python3-numpy java-11-openjdk-devel zlib-devel
Final notes
These requirements will ensure your system is ready to build and run Xmipp. If you encounter problems, please check known issues or report a new one.