Skip to content

Latest commit

 

History

History
96 lines (59 loc) · 4.38 KB

getting-started.md

File metadata and controls

96 lines (59 loc) · 4.38 KB

Getting Started with JADE containers

Setup for Windows Server Editions

To run containers on Windows Server, you need a physical server or virtual machine running Windows Server (Semi-Annual Channel), Windows Server 2022, Windows Server 2019, or Windows Server 2016.

For details on how to install a Docker runtime on windows Server, see the Microsoft tutorial at (https://docs.microsoft.com/en-us/virtualization/windowscontainers/quick-start/set-up-environment?tabs=Windows-Server)

Docker Desktop for Windows 10 and 11

Docker Desktop for Windows is Docker designed to run on Windows 10 and 11. It is a native Windows application that provides an easy-to-use development environment for building, shipping, and running containerized services. Docker Desktop for Windows supports running both Linux and Windows Docker containers, but not at the same time.

Docker Desktop for Windows can use either Windows-native Hyper-V virtualization or a Windows Subsystem for Linux Version 2 (WSL 2) as a backend.

Preparing Your Environment

System Requirements

  • Windows 10 or 11 Professional or Enterprise with Anniversary Update (version 1607) or later.
  • BIOS-level hardware virtualization support must be enabled in your BIOS settings. For more information, see Virtualization.

Setup Script

If you want to skip executing the following steps, then you can run a Powershell script to do them for you. This is setup-container-environment.ps1 script found under the /scripts/ folder. The script is idempotent, which means you can run it several times or do some steps manually and then run the script to complete the setup.

Hyper-V Backend

  • Hyper-V and Containers Windows features must be enabled. To enable them from an admin PowerShell, run:
> Enable-WindowsOptionalFeature -Online -FeatureName Containers -All
> Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

Then restart your computer.

For more information, See Install Hyper-V on Windows 10

Windows Subsystem for Linux version 2 (WSL 2) Backend

  • Windows 10, version 2004 or higher.
  • Enable the WSL 2 feature on Windows. For further instructions, see Microsoft documentation.

Installing Docker Desktop for Windows

Docker Desktop for Windows is the Community version of Docker for Microsoft Windows. This package can be installed using Chocolatey or by downloading and running an installer.

Installing Chocolatey (The Windows Package Manager)

Chocolatey allows you to install packages directly from PowerShell. It can also itself be installed from PowerShell. First, ensure Get-ExecutionPolicy is not Restricted. To determine this, from an admin PowerShell, run:

> Get-ExecutionPolicy

If it returns Restricted, from an admin PowerShell, run:

> Set-ExecutionPolicy AllSigned

You are now ready to install Chocolatey. From an admin PowerShell, run:

> Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

Using Chocolatey (The Windows Package Manager)

From an admin PowerShell, run:

> choco install docker-desktop

The other way: Using an installer

Download and install Docker Community Edition for Windows

Switch to Windows Containers

JADE containers are Windows based so you will need to switch to Windows containers to build and run them. From the Docker Desktop menu, you can toggle which daemon (Linux or Windows) the Docker CLI talks to.

Select Switch to Windows containers to use Windows containers.

You are now all setup and ready to roll with JADE containers.

Get Started with Docker for Windows

If you have not used Docker (or Docker on Windows), visit Get started with Docker for Windows and get familiar with the basics.