Changes for page Install Docker for Windows
Last modified by Erik Bakker on 2025/04/18 13:54
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -26,10 +26,14 @@ 26 26 27 27 ===3.2 Installation requirements Linux=== 28 28 29 -* Whenever Linux is selected as operating system, the latest version of Ubuntu will work 30 -* Install latest version of the Docker engine - see for instance {{code}}https://docs.docker.com/engine/install/ubuntu/{{/code}} 31 -* Go to the next section around installing the eMagiz agent 29 +* Whenever Linux is selected as operating system, the latest version of Ubuntu will work. Other Linux distributions will also work such as Debian or Red Hat. 30 +* Install latest version of the Docker engine - see for instance this link below. For other Linux distributions similar install guides are available on this link. 32 32 32 +{{code}}https://docs.docker.com/engine/install/ubuntu/{{/code}} 33 + 34 + 35 + * Install the eMagiz Deploy agent 36 + 33 33 ===3.3 Installation requirements Windows Server 2022=== 34 34 35 35 These are the requirements to allow the installation of the eMagiz Docker agent: ... ... @@ -37,51 +37,88 @@ 37 37 * Validate if WSL 2.0 is properly installed 38 38 * Go to the next section around installing the eMagiz Docker agent 39 39 44 +===3.3 Installation requirements Windows Server 2022 (without Docker Desktop) === 40 40 41 - {{code language="cmd"}} 42 - #Install docker 43 -sudo apt-get update 44 -sudo apt install --no-install-recommends apt-transport-https ca-certificates curl gnupg2 45 -. /etc/os-release 46 -curl -fsSL https://download.docker.com/linux/${ID}/gpg | sudo tee /etc/apt/trusted.gpg.d/docker.asc 47 -echo "deb [arch=amd64] https://download.docker.com/linux/${ID} ${VERSION_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/docker.list 48 -sudo apt update 49 -sudo apt install docker-ce docker-ce-cli containerd.io 46 +**Step 1: Install linux distribution** 50 50 51 -#Install Java 52 -wget -O - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo apt-key add - 53 -echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list 54 -sudo apt update # update if you haven't already 55 -sudo apt install temurin-8-jdk 48 +{{code language="cmd"}} 49 + wsl --install -d Ubuntu 50 + sudo apt-get update 51 + sudo apt install --no-install-recommends apt-transport-https ca-certificates curl gnupg2 52 + . /etc/os-release 53 +{{/code}} 56 56 57 -#Autostart Dockerd with wsl 58 58 56 +**Step 2: Install Docker ** 57 + 58 +{{code language="cmd"}} 59 + curl -fsSL https://download.docker.com/linux/${ID}/gpg | sudo tee /etc/apt/trusted.gpg.d/docker.asc 60 + echo "deb [arch=amd64] https://download.docker.com/linux/${ID} ${VERSION_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/docker.list 61 + sudo apt update 62 + sudo apt install docker-ce docker-ce-cli containerd.io 63 +{{/code}} 64 + 65 +{{info}} 66 + Requires ~335 Mb space to install 67 +{{/info}} 68 + 69 +**Step 3: Install Java ** 70 + 71 +{{code language="cmd"}} 72 + wget -O - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo apt-key add - 73 + echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list 74 + sudo apt update # update if you haven't already 75 + sudo apt install temurin-8-jdk 76 +{{/code}} 77 + 78 +{{info}} 79 + Requires ~335 Mb space to install 80 +{{/info}} 81 + 82 +**Step 4: Ensure Docker is autostarted with WSL ** 83 + 84 +{{code language="cmd"}} 59 59 nano .bashrc 60 60 87 + #Add following lines to bashrc 61 61 DOCKER_DISTRO="Ubuntu" 62 62 DOCKER_LOG_DIR=$HOME/docker_logs 63 63 mkdir -pm o=,ug=rwx "$DOCKER_LOG_DIR" 64 64 /mnt/c/Windows/System32/wsl.exe -d $DOCKER_DISTRO sh -c "nohup sudo -b dockerd < /dev/null > $DOCKER_LOG_DIR/dockerd.log 2>&1" 92 +{{/code}} 65 65 66 -#Do not ask password dockerd 94 +**Step 5: Add user to Docker group ** 95 + 96 +{{code language="cmd"}} 67 67 sudo visudo 68 68 69 - %dockerALL=(ALL)NOPASSWD:/usr/bin/dockerd99 + #Add following lines 70 70 71 -#Set WSL config for memory 72 -USERDIR/.wslconfig 73 - # Settings apply across all Linux distros running on WSL 2 74 - [wsl2] 101 + # Don't ask for password 102 + %docker ALL=(ALL) NOPASSWD: /usr/bin/dockerd 103 +{{/code}} 75 75 76 - # Limits VM memorytouse no more than 4 GB,this can beset aswholenumbers usingGBor MB77 - =16GB105 +**Step 6: Update wsl config file ** 106 +In this step we need to add or update the WSL config file that manages the resources of the Linux subsystem. Important resources to manage are the assigned memory and number of processors. For memory we recommend to review the mempory settings for the runtime that need to run on this server and add 762 MB to the total value of the heap and non-heap of these runtimes. For processor we recommend to set the value to 2 - depending on the amount of processors available on that machine 78 78 79 - # Sets the VM to use two virtual processors 80 - processors=2 108 +First, locate the config file or add it to the location %USERPROFILE%. The name should be .wslconfig (no extension) 81 81 82 -(Exit WSL: wsl --shutdown) 83 - {{/code}} 84 84 111 +{{code language="cmd"}} 112 + #Add following lines 113 + 114 + # Settings apply across all Linux distros running on WSL 2 115 + [wsl2] 116 + # Limits VM memory to use no more than 4 GB, this can be set as whole numbers using GB or MB 117 + memory=16GB 118 + # Sets the VM to use two virtual processors 119 + processors=2 120 +{{/code}} 121 + 122 + 123 +**Step 7: Auto start the linux subsystem when server restarts ** 124 + 125 + 85 85 ===3.4 Installation requirements Windows Server 2019 version >1806=== 86 86 87 87 These are the requirements to allow the installation of the eMagiz Docker agent: