Installing Docker for Windows

Installing Docker for Windows ensures that the Coveo On-Premises Crawling Module runs smoothly, no matter how your environment configuration. 

It is a best practice to install Docker and the Coveo On-Premises Crawling Module on a Windows Server 2016 virtual machine that has access to the content you want to index. This should prevent environment variable issues.

Installing Docker

  1. Ensure that your environment meets the requirements (see Requirements).
  2. Go to the Docker website and click Get Docker for Windows (Stable).
  3. In the Save As window that appears, choose a location to save the Docker for Windows Installer, and then click Save.
  4. Open a Windows Explorer window and navigate to the selected location.
  5. Double-click the Docker for Windows Installer to run it. An Installing Docker for Windows window opens, displaying the installation progress.
  6. Once the Installing Docker for Windows window displays Installation succeeded, click Close and log out.

    Before clicking Close and log out, save any work that you have in progress, as logging out could close windows and discard unsaved changes.

  7. Log in to your Windows account. Docker for Windows should start automatically.
  8. A Docker for Windows dialog may prompt you to enable Hyper-V. If so, click OK. Your computer will reboot.

    Before clicking OK, save any work that you have in progress, as logging out could close windows and discard unsaved changes.

    Docker for Windows Hyper-V feature not enabled dialog

  9. Once your computer has rebooted, you may encounter an error dialog. Ignore it.

    Docker for Windows error dialog

  10. Switch to Windows containers:
    1. In your system tray, right-click the Docker icon, and then select Switch to Windows containers.

      Right-clicking Docker icon and selecting Switch to Windows Containers

    2. Docker for Windows dialog may prompt you to enable the container feature. If so, click OK. Your computer will reboot.

      Before clicking OK, save any work that you have in progress, as logging out could close windows and discard unsaved changes.

    3. Once your computer has rebooted, a Service is not running dialog may prompt you to start the Docker service. If so, click Start.

Validating the Installation

  1. Make sure that Docker is registered, running, and set to Automatic:
    1. In the task bar, click the Windows icon, and then, in the start menu, click Services.
    2. In the Services window, browse the Services (local) list, looking for Docker for Windows Service. Status should be Running and Startup Type should be Automatic.
  2. Make sure that Docker is working and in Windows Containers mode. Open a command prompt, and then type docker version. The output should not contain any error. Under Server, the OS/Arch value should be windows/amd64.

    Command prompt showing the client versions and server versions

  3. Make sure that Docker will restart after a host reboot:
    1. In your system tray, right-click the Docker icon, and then select Settings.
    2. In the Settings window that appears, in the General tab, ensure that the Start Docker when you log in checkbox is selected.

Allowing A Crawling Account to Use Docker

If you installed Docker with a different Windows Server account than that used to access and crawl your content, you must add the latter to the docker-users group. By default, Docker can only be launched and updated by the user who installed it. Adding your crawling account to the docker-users group allows this account to manage Docker as well.

To add your crawling account as an authorized Docker user:

  1. In the Start menu, search for Edit local users and groups.
  2. In the left-hand side column, click Groups.
  3. Click the docker-users group.
  4. Add the desired account.

What’s Next?

Install Maestro to manage your workers (see Installing Maestro).