---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://catboost.ai/docs/en/installation/r-installation-binary-installation.md
  - href: en/installation/r-installation-binary-installation.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://catboost.ai/docs/en/llms.txt

# Install the released version

<!-- source: en/_includes/work_src/reusage-cli/releases-page.md -->
An up-to-date list of available CatBoost releases and the corresponding binaries for different operating systems is available in the **Download** section of the [releases](https://github.com/catboost/catboost/releases) page on GitHub.

|Operating system|CPU architectures|GPU support using [CUDA](https://developer.nvidia.com/cuda-zone)|
|--------|-----------------|------------|
| macOS (versions currently supported by Apple) | x86_64 and arm64 |no|
| Linux (compatible with [manylinux2014 platform tag](https://peps.python.org/pep-0599/) ) | x86_64 and aarch64 |yes|
| Windows (versions 10, 11, Server 2022, Server 2025) | x86_64 |yes|

{% note info %}

Release binaries for x86_64 CPU architectures are built with SIMD extensions SSE2, SSE3, SSSE3, SSE4 enabled. If you need to run CatBoost on older CPUs that do not support these instruction sets [build CatBoost artifacts yourself](https://catboost.ai/docs/en/concepts/build-from-source.md)

{% endnote %}
<!-- endsource: en/_includes/work_src/reusage-cli/releases-page.md -->


{% note info %}

<!-- source: en/_includes/work_src/reusage-installation/gpu-support-from-the-box__p.md -->
This version has CUDA-enabled GPU support out-of-the-box on Linux and Windows.
<!-- endsource: en/_includes/work_src/reusage-installation/gpu-support-from-the-box__p.md -->

<!-- source: en/_includes/work_src/reusage-code-examples/compute-capability-requirements.md -->
As of CatBoost 1.2.10, devices with CUDA compute capability >= 3.5 are supported in released packages.

All necessary CUDA libraries are statically linked in the released Linux and Windows binaries, the only installation necessary is the appropriate version of the CUDA driver.
<!-- endsource: en/_includes/work_src/reusage-code-examples/compute-capability-requirements.md -->

<!-- source: en/_includes/work_src/reusage-code-examples/nvidia-driver-reqs.md -->
Training or inference on CUDA-enabled GPUs requires NVIDIA Driver of version 450.80.02 or higher.
<!-- endsource: en/_includes/work_src/reusage-code-examples/nvidia-driver-reqs.md -->

{% endnote %}

To install the released R package binary:
1. Run the following commands:
    ```
    install.packages('remotes')
    remotes::install_url('BINARY_URL'[, INSTALL_opts = c("--no-multiarch", "--no-test-load")])
    ```

    - `BINARY_URL` is the URL of the released binary.

       It should look like this:

        `https://github.com/catboost/catboost/releases/download/v{RELEASE_VERSION}/catboost-R-{OS}-{ARCHITECTURE}-{RELEASE_VERSION}.tgz`

        |Operating system|{OS} value|Possible {ARCHITECTURE} values|GPU support using [CUDA](https://developer.nvidia.com/cuda-zone)|
        |--------|-----------------|------------|------------|
        | Linux (compatible with [manylinux2014 platform tag](https://peps.python.org/pep-0599/) ) | `linux` | `x86_64` and `aarch64` |yes|
        | macOS (versions currently supported by Apple) | `darwin` |`universal2` - supports both `x86_64` and `arm64` (Apple silicon)|no|
        | Windows (versions 10, 11, Server 2022, Server 2025) | `windows` | `x86_64` |yes|

    - `INSTALL_opts`:

       - `--no-multiarch` is an optional parameter for multiarch support.
       - `--no-test-load` is an argument which suppresses the testing phase.

    Examples:
    - install the macOS version 1.2.10 of the R package:
    ```
    install.packages('remotes')
    remotes::install_url('https://github.com/catboost/catboost/releases/download/v1.2.10/catboost-R-darwin-universal2-1.2.10.tgz', INSTALL_opts = c("--no-multiarch", "--no-test-load"))
    ```

    - install the Linux version 1.2.10 of the R package for the `aarch64` CPU architecture:
    ```
    install.packages('remotes')
    remotes::install_url('https://github.com/catboost/catboost/releases/download/v1.2.10/catboost-R-linux-aarch64-1.2.10.tgz', INSTALL_opts = c("--no-multiarch", "--no-test-load"))
    ```

    - install the Windows version 1.2.10 of the R package for the `x86_64` CPU architecture:
    ```
    install.packages('remotes')
    remotes::install_url('https://github.com/catboost/catboost/releases/download/v1.2.10/catboost-R-windows-x86_64-1.2.10.tgz', INSTALL_opts = c("--no-multiarch", "--no-test-load"))
    ```

    {% note warning %}

    Do not forget to change the package version to the required one. The example above illustrates the installation of the version 1.2.10.

    To install another version, let's say 0.16.5, change the code to the following:
    ```
    install.packages('remotes')
    remotes::install_url('https://github.com/catboost/catboost/releases/download/v0.16.5/catboost-R-Windows-0.16.5.tgz', INSTALL_opts = c("--no-multiarch", "--no-test-load"))
    ```

    {% endnote %}


<!-- source: en/_includes/work_src/reusage-installation/r__troubleshooting.md -->
#### Troubleshooting {#troubleshooting}

{% cut "Installation error" %}

If you use script for installation, try to add the `repos` parameter to the `install.packages('devtools')` command.
Select any repository from the [list](https://cran.r-project.org/mirrors.html).

Example: `install.packages("devtools", repos="http://cran.us.r-project.org")`.

{% endcut %}

{% cut "ERROR: some hard-coded temporary paths could not be fixed" %}

This can be mitigated by adding "--no-staged-install" option to `INSTALL_opts` parameter of `remotes::install_url` call

{% endcut %}
<!-- endsource: en/_includes/work_src/reusage-installation/r__troubleshooting.md -->