Chapter 2. Install


You install confidential containers on bare-metal servers with the Intel® Trust Domain Extensions (TDX) and AMD SEV-SNP Trusted Execution Environments (TEEs) by configuring your environment and installing the OpenShift sandboxed containers Operator.

Perform the following steps:

  1. Intel® TDX: Create a machine config for your cluster.
  2. Install the OpenShift sandboxed containers Operator.

2.1. Prerequisites

Review the following prerequisites before deploying confidential containers.

  • You have installed the latest version of Red Hat OpenShift Container Platform on the cluster where you are running your confidential containers workload.
Important

Check the Compatibility with OpenShift Container Platform for the specific minimum version required for confidential containers in release 1.12, as it requires a higher version than OpenShift sandboxed containers.

  • You have deployed Red Hat build of Trustee on an OpenShift Container Platform cluster in a trusted environment. For more information, see Deploying Red Hat build of Trustee.
  • Your bare-metal servers are configured for Unified Extensible Firmware Interface (UEFI) boot mode.

    Important

    The OpenShift Container Platform Assisted Installer does not enforce UEFI boot mode during cluster installation. Verify that your server firmware is set to UEFI mode before you deploy confidential containers. Confidential containers workloads cannot run on servers that use legacy BIOS.

2.2. Creating an Intel TDX machine config

If you use Intel® Trust Domain Extensions (TDX), you must create a machine config before you install the Red Hat build of Trustee Operator.

Procedure

  1. Create a tdx-machine-config.yaml manifest file according to the following example:

    apiVersion: machineconfiguration.openshift.io/v1
    kind: MachineConfig
    metadata:
      labels:
        machineconfiguration.openshift.io/role: <role>
      name: 99-enable-intel-tdx
    spec:
      kernelArguments:
      - kvm_intel.tdx=1
      - nohibernate
      config:
        ignition:
          version: 3.2.0
        storage:
          files:
            - path: /etc/modules-load.d/vsock.conf
              mode: 0644
              contents:
                source: data:text/plain;charset=utf-8;base64,dnNvY2stbG9vcGJhY2sK
    <role>
    Specify master for single-node OpenShift or worker for a multi-node cluster.
  2. Create the config map by running the following command:

    $ oc create -f tdx-machine-config.yaml

    Updating the machine config triggers node reboot.

Verification

  • Verify that the machine config is correctly configured by running the following command:

    $ oc get machineconfig 99-enable-intel-tdx

You can install the OpenShift sandboxed containers Operator by using the command line interface (CLI).

Prerequisites

  • You have access to the cluster as a user with the cluster-admin role.

Procedure

  1. Create an osc-namespace.yaml manifest file:

    apiVersion: v1
    kind: Namespace
    metadata:
      name: openshift-sandboxed-containers-operator
  2. Create the namespace by running the following command:

    $ oc create -f osc-namespace.yaml
  3. Create an osc-operatorgroup.yaml manifest file:

    apiVersion: operators.coreos.com/v1
    kind: OperatorGroup
    metadata:
      name: sandboxed-containers-operator-group
      namespace: openshift-sandboxed-containers-operator
    spec:
      targetNamespaces:
      - openshift-sandboxed-containers-operator
  4. Create the operator group by running the following command:

    $ oc create -f osc-operatorgroup.yaml
  5. Create an osc-subscription.yaml manifest file:

    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
      name: sandboxed-containers-operator
      namespace: openshift-sandboxed-containers-operator
    spec:
      channel: stable
      installPlanApproval: Automatic
      name: sandboxed-containers-operator
      source: redhat-operators
      sourceNamespace: openshift-marketplace
      startingCSV: sandboxed-containers-operator.v1.12.0
  6. Create the subscription by running the following command:

    $ oc create -f osc-subscription.yaml
  7. Verify that the Operator is correctly installed by running the following command:

    $ oc get csv -n openshift-sandboxed-containers-operator

    This command can take several minutes to complete.

  8. Watch the process by running the following command:

    $ watch oc get csv -n openshift-sandboxed-containers-operator

    Example output

    NAME                             DISPLAY                                  VERSION         PHASE
    openshift-sandboxed-containers   openshift-sandboxed-containers-operator  1.12.0          Succeeded

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top