1. Documentation
2. 2024.0 (Latest) 10.3 10.2 10.1 10.0 9.10 9.9 9.8 9.7 9.6 9.5 9.4 9.3 9.2 9.1 9.0 8.2 8.1 8.0 7.6
3. Deployment
4. Overview
5. Install Docker on Linux

Install Docker on Linux

If you are unfamiliar with Docker, you may believe that Docker will make your life more complicated. The truth is quite the opposite. Learn just a little about Docker, and you can easily deploy RapidMiner AI Hub, with all its integrated services, via a pre-configured docker-compose template.

Three easy steps, and you're done: Docker does the rest!

1. Ready -- For production purposes, you should install Docker on server hardware (or in the cloud), but you can experiment on your laptop.

   • Check the prerequisites,
   • Download the script, and
   • Install Docker.

2. Set -- Choose a template for your RapidMiner AI Hub, depending on your needs:

   • choose one of several templates that we provide, and
   • copy the template files docker-compose.yml and .env to the machine where you installed Docker.

   These files are pre-configured to work out of the box, but you can modify them to suit your preferences.

3. Go! -- Follow the detailed instructions, and execute the docker-compose commands

4. Docker automagically downloads the images you need, and starts RapidMiner AI Hub.

Before you begin

The emphasis here is on installing Docker on Linux and deploying RapidMiner AI Hub as quickly as possible, using:

1. the Docker quick & easy install script

2. a variety of docker-compose templates.

We start with the following assumptions:

• You have installed or have access to a Linux host, and

  • you can connect to the Linux host via ssh, or
  • you have local access (so that ssh is unnecessary)
• The hostname (or IP address) of the Linux host is <my.linux.host>
• You have root (system administrator) access to the Linux host

All the commands will be issued from the command line, so a GUI is unnecessary. For security reasons you may prefer to run docker as an ordinary user, and assuming there is such a user, we'll call him <rapidminer>.

The brackets here indicate that you must replace <rapidminer> by the actual username and <my.linux.host> by the actual hostname or IP address of the host where RapidMiner AI Hub will be installed.

Download the Docker quick & easy install script

The Docker installation script assumes there is no previous installation of Docker. If Docker is already installed, you can jump ahead to docker-compose templates. If an older version of Docker is installed, you should first uninstall it.

The script installs Docker CE (Community Edition), assuming you are using one of the following Linux distributions, or a derivative:

• CentOS
• Debian
• Fedora
• Oracle Linux
• Red Hat
• SUSE
• Ubuntu

The simplest way to get started is to use curl or wget, assuming one of these commands is pre-installed. If they are not pre-installed, you can first install them, before proceeding as follows:

1. Connect to the Linux host:

    ssh <rapidminer>@<my.linux.host>
   

2. Download the Docker quick & easy install script

   using curl:

    curl -fsSL https://get.docker.com -o get-docker.sh
   

   or wget:

    wget -O get-docker.sh https://get.docker.com/
   

You are now ready to install Docker.

Alternative method: use scp to transfer the script

If you do not yet have curl or wget available on the Linux host, and you don't know how to install them, here is an alternative method for downloading and transferring the script to the host. In general, the method described above is preferred.

1. Download the Docker quick & easy install script to any other computer.

2. Rename the script to get-docker.sh

3. Copy the script to the Linux host using scp or any analogous tool:

     scp get-docker.sh <rapidminer>@<my.linux.host>:
   

   Note the all-important colon (:) at the end of this command. The file is saved on the Linux host in /home/<rapidminer>.

4. Connect to the Linux host:

    ssh <rapidminer>@<my.linux.host>
   

You are now ready to install Docker.

Install Docker

At this point, you are connected to the Linux host, and the quick & easy install script get-docker.sh is in the current working directory. If you type ls get-docker.sh, it should be listed.

When you run the script, it will take the following actions:

• It downloads and installs the software prerequisites for running Docker on Linux, using the tools that are native to your Linux host. If that software is already installed, there will be no change.
• It creates a reference to the Docker Linux repositories in the configuration files, so that you can download (and later update) the Docker software directly.
• It downloads and installs Docker, using the tools that are native to your Linux host.

To install Docker, you must run get-docker.sh as root user. If you did not log in as root, you must first become root. To become root, type one of the following commands:

• If sudo is installed (<rapidminer> password): sudo su

• If sudo is not installed or the <rapidminer> user is not in the sudo group (root password): su

As root user, continue as follows:

1. Start the installation process:

    sh get-docker.sh
   

   Hint: You can simulate installation with the command sh get-docker.sh --dry-run

2. (optional) When installation is completed, you can test docker:

    docker run hello-world
   

3. Install docker-compose, after checking the version number:

    curl -L "https://github.com/docker/compose/releases/download/1.26.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
   
    chmod +x /usr/local/bin/docker-compose
   

4. (optional) Incorporate bash completion:

    curl -L https://raw.githubusercontent.com/docker/compose/1.25.3/contrib/completion/bash/docker-compose -o /etc/bash_completion.d/docker-compose
   

5. (optional) Test docker-compose:

    docker-compose --version
   

6. (recommended) If you plan to run docker-compose as a non-root user, make that user a member of the docker group:

    usermod -aG docker <rapidminer>
   

   To register group membership in the docker group, the <rapidminer> user has to log out and log back in.

Docker is now installed.

More detailed installation documentation can be found on the Docker website, for a variety of Linux distributions.

Read more: Deploy RapidMiner AI Hub using pre-configured deployment templates