Este contenido no está disponible en el idioma seleccionado.

Chapter 4. Installing Red Hat Discovery containers with the disconnected installation process


The disconnected installation process is required when you want to run Red Hat Discovery from a system that does not have internet access, also commonly referred to as a disconnected, offline, or air-gapped environment. During the Red Hat Discovery disconnected installation process, you must complete some steps on a connected system, one that has internet connectivity. These steps include obtaining the container images from the Red Hat Ecosystem Catalog website and then transferring the images to the disconnected system that you intend to use as the Discovery server. You also complete steps on the disconnected system to install, configure the environment for, and start the Discovery containers.

The disconnected installation process uses Podman to install the containers for the Discovery server. You will need sudo permissions to install Podman on your system. However, you must not run the Discovery server using sudo or as the root user.

Prerequisites

Procedure

To install Red Hat Discovery with the disconnected installation process, you do the following tasks:

  • From the connected system, run a series of commands:

    • Access and download the container images.
  • From the disconnected system, run a series of commands:

    • Transfer the container images to the disconnected system.
    • Install, configure, and start the Red Hat Discovery server containers.

During the disconnected installation of the Discovery server, you begin with a connected system to install the Podman container management tool and obtain the Discovery container images on the Red Hat Ecosystem Catalog website. You then transfer those container images to the disconnected system where you want to run Discovery, install Podman on the disconnected system, configure Discovery, and start the Discovery application.

Prerequisites

  • The connected system on which you are downloading the Discovery container images must be connected to the internet.
  • The connected system must be able to connect to the Red Hat Ecosystem Catalog.
  • The disconnected system that you are using must be able to install Red Hat standard packages through dnf.

Procedure

To install the Discovery server with the disconnected installation process, use the following steps:

On the connected system

  1. Log in to the Red Hat Ecosystem Catalog (the registry.redhat.io website). When prompted, supply your Red Hat Customer Portal account credentials.

    podman login registry.redhat.io
    Copy to Clipboard Toggle word wrap
  2. Pull the Discovery container images and save them into as a .tar.gz file.

    podman pull registry.redhat.io/discovery/discovery-ui-rhel9:2.5 registry.redhat.io/discovery/discovery-server-rhel9:2.5 registry.redhat.io/rhel9/postgresql-15:latest registry.redhat.io/rhel9/redis-7:latest
    podman save --multi-image-archive registry.redhat.io/discovery/discovery-ui-rhel9:2.5 registry.redhat.io/discovery/discovery-server-rhel9:2.5 registry.redhat.io/rhel9/postgresql-15:latest registry.redhat.io/rhel9/redis-7:latest | gzip > discovery-images.tar.gz
    Copy to Clipboard Toggle word wrap

On the disconnected system

  1. Use the transfer method of your choice to transfer discovery-images.tar.gz to the disconnected system where you are going to install Discovery:
  2. Load the container images into local storage for Podman.

    podman load -i discovery-images.tar.gz
    Copy to Clipboard Toggle word wrap
  3. Run the following commands to get the discoveryctl package that manages Discovery installation.

    sudo subscription-manager repos --enable <repository>
    sudo dnf install -y discoveryctl
    Copy to Clipboard Toggle word wrap
    Note

    In the preceding command, replace <repository> with the following values:

    • For Red Hat Enterprise Linux 10, replace <repository> with discovery-2-for-rhel-10-x86_64-rpms
    • For Red Hat Enterprise Linux 9, replace <repository> with discovery-2-for-rhel-9-x86_64-rpms
    • For Red Hat Enterprise Linux 8, replace <repository> with discovery-2-for-rhel-8-x86_64-rpms
  4. Run the following command to configure and install Discovery.

    discoveryctl install
    Copy to Clipboard Toggle word wrap
    Note

    When you run the discoveryctl install command for the first time, it will prompt you to define a new admin login username and password. You will use those values to log in to Discovery.

  5. Start the Discovery application.

    systemctl --user start discovery-app
    Copy to Clipboard Toggle word wrap
    Note

    The first time that Discovery runs may take a long time to complete. To get a better idea about the status of the product, the following commands can be run to provide more verbose data during the initial run of Discovery.

    # check if the service is running
    systemctl --user status discovery-app
    Copy to Clipboard Toggle word wrap
    # list all current containers
    podman ps -a
    Copy to Clipboard Toggle word wrap
    # display service logs
    sudo journalctl -t discovery-app
    sudo journalctl -t discovery-server
    Copy to Clipboard Toggle word wrap
    # display and follow service logs
    sudo journalctl -f -t discovery-app
    sudo journalctl -f -t discovery-server
    Copy to Clipboard Toggle word wrap

4.2. Changing the Discovery username and password

You can change the Discovery server login username and password after installation, and your organization may require you to change them periodically. You should choose username and password values that align with common security best practices and your organization’s security standards.

The Discovery server password must meet the following requirements:

  • must be at least ten characters long
  • must contain at least one number
  • must contain at least one letter
  • cannot match the login username
  • cannot match known weak passwords
  • cannot match the previously provided Discovery default password

To reset the username, run the following command and follow the prompts to enter the new username:

discoveryctl reset_admin_username
Copy to Clipboard Toggle word wrap

To reset the password, run the following command and follow the prompts to enter the new password:

discoveryctl reset_admin_password
Copy to Clipboard Toggle word wrap

If Discovery is running when you change the username or password, you must restart Discovery for the new values to take effect.

To restart Discovery, run the following command:

systemctl --user restart discovery-app
Copy to Clipboard Toggle word wrap
Important

Red Hat does not provide support for lost passwords for Discovery, and Discovery does not offer a method to recover passwords; however, you can reset your username or password at any time after installation completes.

4.3. Setting other post-installation preferences

If you want to access Discovery on another computer in the same network, you must allow traffic on TCP port 9443 through any firewall to or on the system that is running the Discovery server.

Red Hat logoGithubredditYoutubeTwitter

Aprender

Pruebe, compre y venda

Comunidades

Acerca de la documentación de Red Hat

Ayudamos a los usuarios de Red Hat a innovar y alcanzar sus objetivos con nuestros productos y servicios con contenido en el que pueden confiar. Explore nuestras recientes actualizaciones.

Hacer que el código abierto sea más inclusivo

Red Hat se compromete a reemplazar el lenguaje problemático en nuestro código, documentación y propiedades web. Para más detalles, consulte el Blog de Red Hat.

Acerca de Red Hat

Ofrecemos soluciones reforzadas que facilitan a las empresas trabajar en plataformas y entornos, desde el centro de datos central hasta el perímetro de la red.

Theme

© 2026 Red Hat
Volver arriba