Docker Setup

Requirements

• Download or clone OWS
• Download and install Visual Studio Code
  • C# Dev Kit extension is required
  • Docker for Visual Studio Code extension is required
• Download and install Docker Desktop for Windows/macOS/Linux
• .Net 8.0 SDK
• Enable “Virtualization Technology” in your BIOS
  
  

Windows

1. Make sure Windows Subsystem for Linux is installed.
2. Download and install Docker Desktop for Windows
3. Open the src folder inside the OWS Project folder and open it with Visual Studio Code.
4. Select View -> Command Palette, Type Docker Compose Up select docker-compose.xml as the compose file.
5. Select Windows Template File

6. Optional
   Running Docker Compose without Visual Studio Code, Enter the following Command Prompt from the OWS root directory.

   docker-compose -f docker-compose.yml -f docker-compose.override.windows.yml -f docker-compose-additional.yml up -d 
   

   For a fresh build use the following command

   docker-compose -f docker-compose.yml -f docker-compose.override.windows.yml -f docker-compose-additional.yml up -d --build --force-recreate 
   

macOS

1. Download and install Docker Desktop for Mac

2. Run the following command in a terminal to install the Development Certificates

   dotnet dev-certs https --trust
   

3. Open the src folder inside the OWS Project folder and open it with Visual Studio Code.
4. Select View -> Command Palette, Type Docker Compose Up select docker-compose.xml as the compose file.
5. Select macOS Template File

6. Optional
   Running Docker Compose without Visual Studio Code, Run the following command in an terminal from the OWS root directory.

   docker-compose -f docker-compose.yml -f docker-compose.override.osx.yml -f docker-compose-additional.yml up -d 
   

   For a fresh build use the following command

   docker-compose -f docker-compose.yml -f docker-compose.override.osx.yml -f docker-compose-additional.yml up -d --build --force-recreate 
   

Linux

1. Download and install Docker Desktop for Linux
2. Close all web browsers
3. Download and Run dotnet-dev-certificate-linux to install Development HTTPS Certificate.
4. Open the src folder inside the OWS Project folder and open it with Visual Studio Code.
5. Select View -> Command Palette, Type Docker Compose Up select docker-compose.xml as the compose file.
6. Select Linux Template File

7. Run the following command in an terminal from the OWS src directory.

   sudo docker-compose -f docker-compose.yml -f docker-compose.override.linux.yml -f docker-compose-additional.yml up -d 
   

   For a fresh build use the following command

   sudo docker-compose -f docker-compose.yml -f docker-compose.override.linux.yml -f docker-compose-additional.yml up -d --build --force-recreate 
   

Next: Database setup