Get started with DHI Select and Enterprise

1. Go to Docker Hub and sign in.

2. Select your organization in the left sidebar.

3. Navigate to Hardened Images > Catalog.

4. Use the search bar or filters to find an image (for example, python, node, or golang). For this example, search for python.

   To search for an image with a compliance variant (FIPS or STIG), select Filter by and select the relevant compliance option.

5. Select the Python repository to view its details.

6. Select Images to view available image variants.

1. List available image repositories:

   $ docker dhi catalog list --type image
   

2. To filter by name and FIPS compliance, use the --filter and --fips flags:

   $ docker dhi catalog list --filter python --fips
   

3. Get image details for the repository:

   $ docker dhi catalog get python
   

1. In the image repository details page you found in the previous step, select Use this image > Mirror repository. Note that you must be signed in to Docker Hub to perform this action.
2. Select Mirror.
3. Wait for images to finish mirroring. This can take a few minutes.
4. Verify the mirrored repository appears in your organization namespace with a dhi- prefix (for example, dhi-python).

To use the following commands, you must authenticate or configure DHI CLI authentication using your Docker token. For details, see Use the DHI CLI.

1. Start mirroring the repository to your organization namespace. Replace <your-org> with your organization name.

   $ docker dhi mirror start --org <your-org> \
       -r dhi/python,<your-org>/dhi-python
   

2. Wait for images to finish mirroring. This can take a few minutes.

3. Verify the mirrored repository. Replace <your-org> with your organization name.

   $ docker dhi mirror list --org <your-org>
   

1. Go to your organization namespace on Docker Hub.
2. Navigate to your mirrored repository (for example, dhi-python).
3. Select Customizations.
4. Select Create customization.
5. Search for 3-alpine3.23 and select any one of the images.
6. In Add packages, select curl.
7. Select Next: Configure.
8. In Customization name, enter a name for your customization (for example, curl).
9. Select Next: Review customization.
10. Select Create customization to start the build.

It can take a few minutes for the customization to build. Go to the Customizations tab of your mirrored repository and view the Last build column to monitor the build status.

To use the following commands, you must authenticate or configure DHI CLI authentication using your Docker token. For details, see Use the DHI CLI.

1. Create a customization. Replace <your-org> with your organization name. This creates a file called my-customization.yaml with the customization details.

   $ docker dhi customization prepare --org <your-org> python 3-alpine3.23 \
       --destination <your-org>/dhi-python \
       --name "python with curl" \
       --output my-customization.yaml
   

2. Add the curl package to the customization. You can edit the file with any text or code editor. The following commands use echo to add the necessary lines to the YAML file:

   $ echo "contents:" >> my-customization.yaml
   $ echo "  packages:" >> my-customization.yaml
   $ echo "    - curl" >> my-customization.yaml
   

3. Apply the customization:

   $ docker dhi customization create --org <your-org> my-customization.yaml
   

4. Verify the customization was created:

   $ docker dhi customization list --org <your-org>
   

It can take a few minutes for the customization to build. To check the build status:

1. Go to your organization namespace on Docker Hub.
2. Navigate to your mirrored repository (for example, dhi-python).
3. Select Customizations.
4. View the Last build column to monitor the build status.