docs/src/install.md

---
title: Build Instructions
---

The build processes uses CMake starting with UCX 3.0.
First, download the source code from [Source Forge][1].

    wget https://sourceforge.net/projects/ucx/files/ucx-latest.tar.gz
    tar -xzf ucx-latest.tar.gz
    cd ucx-latest
    
Then create a build directory and use cmake to create the build files,
execute the build, and - optionally - install the files.

    mkdir build
    cd build
    cmake ..
    cmake --build .
    sudo cmake --install .

---

### UCX 2.1

The build procedure for UCX 2.1 uses a configure script.
For Microsoft Windows, you will need an appropriate port of the linux
tools (like MinGW or Cygwin).
First, download the source code from [Source Forge][1].

    wget https://sourceforge.net/projects/ucx/files/ucx-2.1.0.tar.gz
    tar -xzf ucx-2.1.0.tar.gz
    cd ucx-2.1.0

Then issue the `configure` and `make` commands.

    ./configure && make

To verify your installment you can issue `make check`. If everything is fine,
you can install UCX with

    make install
    
Note, that you might need administrative privileges for a system wide
installation.

[1]: https://sourceforge.net/projects/ucx/files/