Pull Docker images

This page provides the procedure to deploy Cyberwatch docker images on a disconnected machine.

Download docker images

  1. Connect to a machine with access to https://dl.cyberwatch.fr.

  2. On Linux, set these two environment variables with your Cyberwatch credentials:

    The credentials are in the license email sent by Cyberwatch. They are the same used to access Cyberwatch’s container registries.

    export CBW_USER=
    export CBW_PASSWORD=
    
  3. Download the images archive by using one of the 3 methods below:

    • With curl:

       curl -u "$CBW_USER:$CBW_PASSWORD" -JLO https://dl.cyberwatch.fr/download_images
      
    • With wget:

       wget --http-user="$CBW_USER" --http-password="$CBW_PASSWORD" \
         --content-disposition https://dl.cyberwatch.fr/download_images
      
    • With PowerShell cmdlet Invoke-WebRequest:

       $pair = "$($CBW_USER):$($CBW_PASSWORD)"
       $encodedCredentials = [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes($Pair))
       $headers = @{ Authorization = "Basic $encodedCredentials" }
       Invoke-WebRequest -Uri 'https://dl.cyberwatch.fr/download_images' -Method Get -Headers $headers -Outfile images_cbwonpremise_{version}.tar.gz
      
    • Manually:

      1. Go to URL https://dl.cyberwatch.fr/images/ with a web browser.
      2. Download the last version of the archive.
  4. (Optional) Check the integrity of the downloaded file to ensure that the download is complete:

    • Download the sha256 checksum file of the previously downloaded archive:

      • With curl:

          curl -u "$CBW_USER:$CBW_PASSWORD" -JLO \
            https://dl.cyberwatch.fr/images/$(ls images_cbwonpremise_*.tar.gz).sha256
        
      • With wget:

          wget --http-user="$CBW_USER" --http-password="$CBW_PASSWORD" \
            --content-disposition https://dl.cyberwatch.fr/$(ls images_cbwonpremise_*.tar.gz).sha256
        
      • Manually:

        1. Go to URL https://dl.cyberwatch.fr/images/ with a web browser.
        2. Download the sha256 checksum file associated with the previously downloaded archive.
    • Check the integrity:

       sha256sum -c images_cbwonpremise_*.tar.gz.sha256
      

Import images to the disconnected machine

  1. Import the archive to the disconnected machine.
  2. Load the docker images:

    docker image load -i images_cbwonpremise_*.tar.gz
    
  3. Check that the images have been imported:

    docker images
    

    The images must all have a name and a tag.


Back to top