Build MIOpen using Docker

You can build MIOpen using Docker by either downloading a prebuilt image or creating your own.

Note

For ease of use, we recommended using the prebuilt Docker image.

• Downloading a prebuilt image

  You can find prebuilt Docker images at ROCm Docker Hub.

• Building your own image

  docker build -t miopen-image .
  

  To enter the development environment, use docker run. For example:

  docker run -it -v $HOME:/data --privileged --rm --device=/dev/kfd --device /dev/dri:/dev/dri:rw
  --volume /dev/dri:/dev/dri:rw -v /var/lib/docker/:/var/lib/docker --group-add video
  --cap-add=SYS_PTRACE --security-opt seccomp=unconfined miopen-image
  

  Once in the Docker environment, use git clone MIOpen. You can now start building MIOpen using CMake.

Building MIOpen from source

Use the following instructions to build MIOpen from source.

1. Create a build directory:

   mkdir build; cd build;
   

2. Configure CMake using either an MIOpen or a HIP backend.

   MIOpen backend:

   Set your preferred backend using the -DMIOPEN_BACKEND CMake variable.

   HIP backend (ROCm 3.5 and later):

   First, set the C++ compiler to clang++:

   export CXX=<location-of-clang++-compiler>
   

   Then, run the following command to configure CMake:

   cmake -DMIOPEN_BACKEND=HIP -DCMAKE_PREFIX_PATH="<hip-installed-path>;<rocm-installed-path>;<miopen-dependency-path>" ..
   

   For example, you can set CMake to:

   export CXX=/opt/rocm/llvm/bin/clang++ && \
   cmake -DMIOPEN_BACKEND=HIP -DCMAKE_PREFIX_PATH="/opt/rocm/;/opt/rocm/hip;/root/MIOpen/install_dir" ..
   

   Note

   When specifying the path for CMAKE_PREFIX_PATH, do not use the tilde (~) shorthand for the home directory.

Choosing an install location

By default, the install location is set to /opt/rocm. If you used a different install location, set your install path using CMAKE_INSTALL_PREFIX:

cmake -DMIOPEN_BACKEND=OpenCL -DCMAKE_INSTALL_PREFIX=<miopen-installed-path> ..