Skip to content

quick_start_windows_wsl.md

Latest commit

 

History

History
97 lines (62 loc) · 3 KB

quick_start_windows_wsl.md

File metadata and controls

97 lines (62 loc) · 3 KB

🔙 Back to readme page

Quick start: Windows WSL2

Follow these instructions to install and run dockered-itop on Windows.

Prerequisites

Windows 10 > versions 2004 (>= build 19041) or Windows 11.

Git for Windows Official Install

1️⃣ Install Docker Desktop

Follow official installation instructions.
Choose WSL2 integration during installation.

Download Docker Desktop for Windows

Official Docker installation Instructions

Once installed on your computer, Docker Desktop allow you to launch a docker environment on your Windows machine but this is not the way we will use it, due to performance consideration.
We will use WSL2 to create a linux docker host.

2️⃣ Create a WSL2 host

This is the environment we will use to launch docker containers.

  • Launch windows terminal

  • Install a new WSL2 host\

wsl --install -d ubuntu --name dockered-itop

Note

Browse How WSL2 documentation if you need more information.

3️⃣ Register the new host in Docker Desktop

You need to allow running docker in our new host.
Open Docker Desktop and go to settings > Resources > WSL Integration then check the new host.

Start Menu

️4️⃣ Run environment

  • Launch host terminal Windows Start Menu > All apps > dockered-itop

Start Menu

git config --global credential.helper "/mnt/c/Users/{MY_USER}/AppData/Local/Programs/Git/mingw64/bin/git-credential-manager.exe"

Warning

The git path may change depending on your Git for Windows installation.
For older versions, you may need to use this path: /mnt/c/Program\ Files/Git/mingw64/bin/git-credential-manager.exe.

  • Clone dockered-itop project\
git clone https://github.com/Combodo/docker_environment.git
  • Change current directory to dockered-itop directory\
cd dockered_environment
  • Copy the containers default configuration files\
cp -R build/default_configuration/* conf
  • Create a copy of .env file as .env.local to set your own configuration, like data folders, database password, web server you want to use, ports....
cp .env .env.local
  • Run docker-compose\
docker-compose --env-file .env.local up -d

️✅ You are ready to go!

You can now access web resources here http://localhost:80



🔙 Back to readme page