Chapter 1. Deploy the Red Hat Offline Knowledge Portal for use on a single system

Procedure

1. Use Podman to download the Red Hat Offline Knowledge Portal:

   1. Enter the following command in a terminal and use your Customer Portal, Red Hat Developer, or registry service account credentials to log in to registry.redhat.io:

      $ podman login registry.redhat.io
      username: <username>
      Password: <password>

      Copy to Clipboard Toggle word wrap

      where:

      <username>

      Specifies your Customer Portal, Red Hat Developer, or registry service account user name.

      <password>

      Specifies your Customer Portal, Red Hat Developer, or registry service account password.

   2. Download the Red Hat Offline Knowledge Portal image:

      $ podman pull registry.redhat.io/offline-knowledge-portal/rhokp-rhel9:latest

      Copy to Clipboard Toggle word wrap

2. Get your Red Hat Offline Knowledge Portal access key:

   1. Navigate to the Red Hat Offline Knowledge Portal Access Key Generator page, click Generate key, and then copy the key to your clipboard. After you generate your access key, the key is stored in your Red Hat account.
   2. Optional: If you need the key again, click Generate Key to display the previously generated key.
   3. Optional: If your access key is compromised, report a bug to unbind your access key so you can generate a new one.

3. To launch the Red Hat Offline Knowledge Portal with https using the self-signed certificate Podman generates, enter the following command:

   $ podman run --rm -p 8080:8080 -p 8443:8443 \
   --env "ACCESS_KEY=<your_personal_access_key>" \
   -d registry.redhat.io/offline-knowledge-portal/rhokp-rhel9:latest

   Copy to Clipboard Toggle word wrap

   where:

   <your_personal_access_key>

   Specifies the access key that you generated in the previous step. The podman run command includes your access key. Without the correct access key, you cannot view encrypted content or use certain features, such as search.