Docker Setup

Requirements

  • Download or clone OWS
  • Download and install Visual Studio 2022 Community
    • The ASP.NET and Web Development, Node.js Development, and Game development with C++ workloads are 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. Launch Docker Compose
  2. Download and install Docker Desktop for Windows
  3. Open OWS Project in Visual Studio 2022 Community. The ASP.NET and Web Development workload is required. The “Node.js development” workload is also required for the Vue.js build process. If you plan to use Unreal Engine, you will also need to install the “Game development with C++” workload.
  4. Select Docker Compose startup project and Launch Docker Compose. Launch Docker Compose

  5. Optional
    Running Docker Compose without Visual Studio Debugger, 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. Open OWS Project in Visual Studio For Mac. The ASP.NET and Web Development workload is required.

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

    dotnet dev-certs https --trust
  4. Select Docker Compose startup project and Launch Docker Compose. Launch Docker Compose

  5. Optional
    Running Docker Compose without Visual Studio Debugger, 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. 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