Manage Altair AI Hub

When managing Altair AI Hub, recall that configuration occurs at multiple levels:

  1. The landing page

    From the landing page of Altair AI Hub, numerous configuration tools are available, described collectively in Admin Tools and, according to the topic, in the submenus, e.g. Users and Groups.

  2. The platform's REST API

    The complete REST API documentation of Altair AI Hub is available as OpenApi 3.0 specification and is published on SwaggerHub.

  3. The platform's environment file

    At the platform level, you can configure Altair AI Hub via the environment file for docker-compose.

    For each Docker image, the environment variables are discussed in detail within the Image Reference.

  4. Within containers

    Before the arrival of a container-based architecture, AI Hub Server was a free standing entity; now it is packaged within a Docker image. Hence, to add to or modify the files within the home directory, you must first get access to the AI Hub Server container.

The landing page


The administration tools can be found under the following headings.

Identity and Security

Users and groups are managed via Keycloak.

Platform Administration

Platform Administration provides a user interface for the following tasks:


Here the admin can create, delete, and configure projects.

Executions and schedules

Here the admin can manage the job execution infrastructure.

Editing files within containers: the home directory

Frequently, this documentation will refer to the home directory, using a terminology such as <rapidminer-home> or <rapidminer-server-home>, to distinguish it from the home directory of the Job Agents. If you want to make changes to files within the home directory, you must first get access to it.

  1. Find the container running aihub-backend:

     $ docker container ls | grep aihub-backend
     63b24f5fb5c9   rapidminer/rapidminer-aihub:10.1.0
  2. Enter the running container:

     $ docker exec -it <CONTAINER_ID> bash
  3. Within the container, find the home directory

     rapidminer@aihub-backend:/$ ls aihub/home
     config  data  log  resources  tmp
  4. Edit the file of interest with an available editor, such as nano or vim.

  5. Exit the container:

     rapidminer@aihub-backend:/$ exit
  6. Restart aihub-backend:

     $ docker-compose restart aihub-backend

Similarly, the home directory of the Job Agents (<job-agent-home>) can be found in the aihub-job-agent container, under /jobagent/home.