Installing iCR Using RPM Package Management

To install an RPM package on a RedHat Linux distribution platform, you can use yum or its newer option dnf. For this description we will use dnf.

NOTE: It is assumed that any necessary support software, such as Docker, have already been installed on the server. Links to that are provided in the Installing iCR section.

NOTE: dnf requires that you have superuser privileges in order to install new packages. So all commands will be preceded with the sudo directive.

The first step is to tell the package management infrastructure where to find the OpenRefactory repository containing the iCR RPM packages. This is accomplished with the following command: sudo wget -O /etc/yum.repos.d/icr.repo https://rpm.openrefactory.com/icr.repo

Then, you need to update the state of the RPM repositories with this command: sudo dnf repolist

From this you will see that icr is in the list of available repositories. Now, install iCR using the following command:sudo dnf install icr-6.0.0

Once the installation begins, you should see progress initiated with output similar to:

Last metadata expiration check: 0:25:40 ago on Thu Jun  5 21:49:36 2025.
Dependencies resolved.
============================================================================================================================================
 Package                        Architecture                      Version                              Repository                      Size
============================================================================================================================================
Installing:
 icr                            x86_64                            6.0.0-1                              icr                            5.4 M

Transaction Summary
============================================================================================================================================
Install  1 Package

Total download size: 5.4 M
Installed size: 57 M
Is this ok [y/N]: y
Downloading Packages:
icr-6.0.0-1.x86_64.rpm                                                                                      8.1 MB/s | 5.4 MB     00:00    
--------------------------------------------------------------------------------------------------------------------------------------------
Total                                                                                                       8.0 MB/s | 5.4 MB     00:00     
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
  Preparing        :                                                                                                                    1/1 
  Installing       : icr-6.0.0-1.x86_64                                                                                                 1/1 
  Running scriptlet: icr-6.0.0-1.x86_64                                                                                                 1/1 

This shows that the package installation has begun and the package is being downloaded. The iCR package is large and will take a while, likely minutes to download before further progess is shown. Once downloaded you should see progress similar to this:

Pulling required Docker images. This may take a few minutes...

Pulling Docker image: openrefactory/icr-unified-navrev:6.0.0...
[##############################-] 100%
openrefactory/icr-unified-navrev:6.0.0 pulled successfully.

Pulling Docker image: openrefactory/icr-java-iso:5.1.0...
[##############################-] 100%
openrefactory/icr-java-iso:5.1.0 pulled successfully.

Pulling Docker image: openrefactory/icr-python-iso:5.1.0...
[##############################-] 100%
openrefactory/icr-python-iso:5.1.0 pulled successfully.

Pulling Docker image: openrefactory/icr-go-iso:5.1.0...
[##############################-] 100%
openrefactory/icr-go-iso:5.1.0 pulled successfully.

Pulling Docker image: openrefactory/icr-rust-iso:6.0.0...
[##############################-] 100%
openrefactory/icr-rust-iso:6.0.0 pulled successfully.

Pulling Docker image: openrefactory/icr-worker:6.0.0...
[##############################-] 100%
openrefactory/icr-worker:6.0.0 pulled successfully.

Pulling Docker image: mongo:6.0...
[##############################-] 100%
mongo:6.0 pulled successfully.

All Docker images pulled successfully!

  Verifying        : icr-6.0.0-1.x86_64                                                                                                 1/1 

Installed:
  icr-6.0.0-1.x86_64                                                                                                                        

Complete!

This shows that all of the required Docker components are installed into the local Docker registry and are available for use. You can check that everything is OK by running the command:docker images

You should see the following images displayed:

REPOSITORY                         TAG       IMAGE ID       CREATED        SIZE
openrefactory/icr-rust-iso         6.0.0     c3e8fa4feec5   37 hours ago   1.36GB
mongo                              6.0       bb8c079588cc   2 days ago     749MB
openrefactory/icr-unified-navrev   6.0.0     84c16b4d3da3   3 days ago     1.83GB
openrefactory/icr-worker           6.0.0     be85568e7deb   9 days ago     1.1GB
openrefactory/icr-java-iso         5.1.0     5591500dc864   7 weeks ago    1.96GB
openrefactory/icr-python-iso       5.1.0     e06f45081ad3   2 months ago   2.54GB
openrefactory/icr-go-iso           5.1.0     70099e83b478   2 months ago   777MB

Once the Docker containers are installed, the installation also sets up the icr command for you so that you can immediately use it to do any other configuration that may be required. How to use the icr command is outlined in the following section Managing your Service. The required End User License Agreement (EULA) must be reviewed. It is assumed that going forward with using iCR implies that you have read and accepted the EULA. You can find the EULA along with the complete SBOM for all of the libraries included in iCR in the /usr/share/icr-release directory.

If there becomes a reason for you to require iCR to be removed from your platform, you may do so using the following command:sudo dnf remove icr

NOTE: If you decide to remove the iCR package, please be aware that deleting the package will ALSO delete the results of any analyses that were completed in the past and all historical data will be removed.

With iCR correctly installed, you will need to configure it before you can begin analyzing your projects. This is covered in the following section: Managing Your Service.