.. _install-on-windows: Windows 10 ---------- This section describes how to install, start, stop, and upgrade Driverless AI on a Windows 10 machine. The installation steps assume that you have a license key for Driverless AI. For information on how to obtain a license key for Driverless AI, visit https://h2o.ai/o/try-driverless-ai/. Once obtained, you will be prompted to paste the license key into the Driverless AI UI when you first log in, or you can save it as a .sig file and place it in the \license folder that you will create during the installation process. Overview of Installation on Windows ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ To install Driverless AI on Windows, use a Driverless AI Docker image. **Notes**: - GPU support is not available on Windows. - Scoring is not available on Windows. **Caution**: Installing Driverless AI on Windows 10 is not recommended for serious use. Environment ~~~~~~~~~~~ +-----------------------+---------------+---------+-----------------+ | Operating System | GPU Support? | Min Mem | Suitable for | +=======================+===============+=========+=================+ | Windows 10 Pro | No | 16 GB | Experimentation | +-----------------------+---------------+---------+-----------------+ | Windows 10 Enterprise | No | 16 GB | Experimentation | +-----------------------+---------------+---------+-----------------+ | Windows 10 Education | No | 16 GB | Experimentation | +-----------------------+---------------+---------+-----------------+ **Note**: Driverless AI cannot be installed on versions of Windows 10 that do not support Hyper-V. Refer to https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/reference/hyper-v-requirements for more information. Docker Image Installation ~~~~~~~~~~~~~~~~~~~~~~~~~ **Notes**: - Be aware that there are known issues with Docker for Windows. More information is available here: https://github.com/docker/for-win/issues/188. - Consult with your Windows System Admin if - Your corporate environment does not allow third-part software installs - You are running Windows Defender - You your machine is not running with ``Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux``. **Watch the installation video** `here `__. Note that some of the images in this video may change between releases, but the installation steps remain the same. Requirements ''''''''''''' - Windows 10 Pro / Enterprise / Education - Docker Desktop for Windows 2.2.0.3 (42716) **Note**: As of this writing, Driverless AI has only been tested on Docker Desktop for Windows version 2.2.0.3 (42716). Installation Procedure '''''''''''''''''''''' 1. Retrieve the Driverless AI Docker image from https://www.h2o.ai/download/. 2. Download, install, and run Docker for Windows from https://docs.docker.com/docker-for-windows/install/. You can verify that Docker is running by typing ``docker version`` in a terminal (such as Windows PowerShell). Note that you may have to reboot after installation. 3. Before running Driverless AI, you must: - Enable shared access to the C drive. Driverless AI will not be able to see your local data if this is not set. - Adjust the amount of memory given to Docker to be at least 10 GB. Driverless AI won’t run at all with less than 10 GB of memory. - Optionally adjust the number of CPUs given to Docker. You can adjust these settings by clicking on the Docker whale in your taskbar (look for hidden tasks, if necessary), then selecting **Settings > Shared Drive** and **Settings > Advanced** as shown in the following screenshots. Don’t forget to Apply the changes after setting the desired memory value. (Docker will restart.) Note that if you cannot make changes, stop Docker and then start Docker again by right clicking on the Docker icon on your desktop and selecting **Run as Administrator**. .. image:: ../images/windows_docker_menu_bar.png :align: center :width: 252 :height: 262 \ .. image:: ../images/windows_shared_drive_access.png :align: center :scale: 40% \ .. image:: ../images/windows_docker_advanced_preferences.png :align: center :width: 502 :height: 326 4. Open a PowerShell terminal and set up a directory for the version of Driverless AI on the host machine: .. code-block:: bash :substitutions: md |VERSION-dir| 5. With Docker running, navigate to the location of your downloaded Driverless AI image. Move the downloaded Driverless AI image to your new directory. 6. Change directories to the new directory, then load the image using the following command: .. code-block:: bash :substitutions: cd |VERSION-dir| docker load -i .\dai-docker-ubi8-x86_64-|VERSION-long|.tar.gz 7. Set up the data, log, license, and tmp directories (within the new directory). .. code-block:: bash md data md log md license md tmp 8. Copy data into the **/data** directory. The data will be visible inside the Docker container at **/data**. 9. Run ``docker images`` to find the image tag. 10. Start the Driverless AI Docker image. Be sure to replace ``path_to_`` below with the entire path to the location of the folders that you created (for example, "c:/Users/user-name/driverlessai_folder/data"). Note that this is regular Docker, not NVIDIA Docker. GPU support will not be available. Note that from version 1.10 DAI docker image runs with internal ``tini`` that is equivalent to using ``--init`` from docker, if both are enabled in the launch command, tini prints a (harmless) warning message. We recommend ``--shm-size=2g --cap-add=SYS_NICE --ulimit nofile=131071:131071 --ulimit nproc=16384:16384`` in docker launch command. But if user plans to build :ref:`image auto model ` extensively, then ``--shm-size=4g`` is recommended for Driverless AI docker command. .. code-block:: bash :substitutions: docker run --pid=host --rm --shm-size=2g --cap-add=SYS_NICE --ulimit nofile=131071:131071 --ulimit nproc=16384:16384 -p 12345:12345 -v c:/path_to_data:/data -v c:/path_to_log:/log -v c:/path_to_license:/license -v c:/path_to_tmp:/tmp h2oai/dai-ubi8-x86_64:|tag| 11. Connect to Driverless AI with your browser at http://localhost:12345. Stopping the Docker Image ''''''''''''''''''''''''' .. include:: stop-docker.rst Upgrading the Docker Image '''''''''''''''''''''''''' .. include:: upgrade-docker.rst