Deploying Dataedo portal on Windows with Docker

You can deploy Dataedo Portal using Docker or IIS. This guide explains how to set up Docker on Windows and deploy the portal. If you want to use IIS, use this guide instead.

info

This guide is based on Jonathan Bowman's guide on setting up Linux on WSL.

Deployment steps

Before starting, ensure your environment meets the prerequisites and is properly configured for running Docker on Windows. Check this guide if you need to install Docker.

Step 1: Install and configure WSL

1. First, set up the Windows Subsystem for Linux (WSL). Open the Command Prompt as administrator and run these commands to install WSL:

   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
   dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

2. After completing these steps, restart Windows. Then open Command Prompt again as administrator and run:

   wsl --set-default-version 2

Step 2: Install Ubuntu 22.04 LTS

1. Now, you can, install Linux distribution. Download Ubuntu 22.04 LTS from the Microsoft Store.

2. Once you've installed it, open the new Ubuntu terminal window, and set up a main user and password.

   tip

   If the window doesn’t open automatically, restart Windows and retry the installation.

3. (Optional) Download the Windows Terminal for an improved experience.

Step 3: Install prerequisites for Docker

1. Open the Ubuntu terminal and update the package list:

   sudo apt update && sudo apt upgrade
   sudo apt install --no-install-recommends apt-transport-https ca-certificates curl gnupg2

2. Update the network configuration to ensure Docker works with the firewall:

   update-alternatives --config iptables

3. When prompted, select iptables-legacy.

Step 4: Install Docker

1. Add Docker's official repository to ensure compatibility:

   . /etc/os-release
   curl -fsSL https://download.docker.com/linux/${ID}/gpg | sudo tee /etc/apt/trusted.gpg.d/docker.asc
   echo "deb [arch=amd64] https://download.docker.com/linux/${ID} ${VERSION_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/docker.list
   sudo apt update

2. Then, install Docker:

   sudo apt install docker-ce docker-ce-cli containerd.io

Step 5: Configure user permissions for Docker

1. Add your user to the Docker group to avoid using sudo every time:

   sudo usermod -aG docker $USER

2. To confirm, restart the Ubuntu terminal and run:

   groups

3. Ensure that docker is listed. If not, retry the previous command.

4. Next, assign a group ID to Docker. Verify that the group ID is available:

   getent group | grep 36257 || echo "This ID is not in use."

5. After confirming, update the group configuration:

   sudo sed -i -e 's/^\(docker:x\):[^:]\+/\1:36257/' /etc/group

6. Restart the WSL instance:

   wsl --shutdown

7. Then, reopen Ubuntu and run the following commands to configure Docker's directory:

   DOCKER_DIR=/mnt/wsl/shared-docker
   mkdir -pm o=,ug=rwx "$DOCKER_DIR"
   chgrp docker "$DOCKER_DIR"
   sudo mkdir /etc/docker/

8. Create the Docker configuration file:

   sudo nano /etc/docker/daemon.json

9. Paste the following content:

   {
     "hosts": ["unix:///mnt/wsl/shared-docker/docker.sock"]
   }

10. Save and close the editor. Start Docker:

    sudo dockerd

11. If it doesn’t start, kill the previous process and try again:

    sudo kill PID
    sudo dockerd

12. Finally, test the configuration in a new terminal tab:

    export DOCKER_HOST="unix:///mnt/wsl/shared-docker/docker.sock"
    docker run --rm hello-world

Step 6: Set Docker to Autostart

1. To enable Docker autostart, edit the .bashrc file running the following command in your terminal:

   sudo nano .bashrc

2. Add the following at the end of the file:

   # Docker autostart
   DOCKER_DISTRO="Ubuntu-22.04"
   DOCKER_DIR=/mnt/wsl/shared-docker
   DOCKER_SOCK="$DOCKER_DIR/docker.sock"
   export DOCKER_HOST="unix://$DOCKER_SOCK"
   if [ ! -S "$DOCKER_SOCK" ]; then
       mkdir -pm o=,ug=rwx "$DOCKER_DIR"
       chgrp docker "$DOCKER_DIR"
       /mnt/c/Windows/System32/wsl.exe -d $DOCKER_DISTRO sh -c "nohup sudo -b dockerd < /dev/null > $DOCKER_DIR/dockerd.log 2>&1"
   fi

3. Save and close the editor.

4. Set up a Windows Scheduler task to run Docker on startup. Add a task with the following action:

   "C:\Windows\System32\wsl.exe" -d Ubuntu-22.04

Step 7: (Optional) allow passwordless access to Docker

1. If prompted for a password every time, enable passwordless access:

   sudo visudo

2. Add the following lines to the end of the file:

   %docker ALL=(ALL) NOPASSWD: /usr/bin/dockerd

3. Save and exit.

Step 8: Add the Dataedo portal Docker image

Now, you can follow this guide to add the Dataedo Portal Docker image.

Need help?

If you run into any problems or have questions, reach out to Dataedo support.