Installing FLECS Core on a Windows PC using Docker Desktop

This guide provides step-by-step instructions for installing and setting up FLECS Core on a Windows PC using Docker Desktop.

---

Prerequisites

• Windows PC with Docker Desktop installed and configured.

  • Ensure Docker Desktop is running properly and has the necessary resources allocated (at least 2 CPUs and 4 GB RAM).

• Administrator privileges on your PC.

• Internet access to download Docker images.

---

Step 1: Install Docker Desktop

1. Download Docker Desktop Visit the official Docker website and download the installer for Windows.

2. Install Docker Desktop Follow the installation wizard to set up Docker Desktop on your PC.

3. Enable WSL 2 Backend Support Docker Desktop utilizes WSL 2 (Windows Subsystem for Linux) for efficient container execution. Ensure this is enabled during installation.

4. Start Docker Desktop Verify that the Docker daemon is running before proceeding with the installation.

---

Step 2: Prepare the Docker Compose File

Choose an Installation Directory

The folder where you install FLECS Core is entirely up to you. For this example, we'll use C:\flecs-core. Open Command Prompt or PowerShell and run:

mkdir C:\flecs-core
cd C:\flecs-core

Retrieve the Latest Docker Compose File

The latest version of the docker-compose.yml file can always be found in the official documentation at: https://docs.flecs.tech/product-docs/engineering/flecs-core/install-flecs-core-using-docker

Download or Copy the Compose File

For demonstration purposes, here is an example configuration you can use:

version: "3.7"
services:
  flecsd:
    image: flecspublic.azurecr.io/flecs-slim:3.5.0-hedgehog
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - flecsd:/var/lib/flecs
    restart: always
    network_mode: host
    command: 172.21.0.1
  webapp:
    image: flecspublic.azurecr.io/webapp:3.5.0-hedgehog
    ports:
      - 8081:80
    depends_on:
      - flecsd
    restart: always
    extra_hosts:
      - flecs-floxy:172.21.0.1
    networks:
      flecs:
        ipv4_address: 172.21.255.254
volumes:
  flecsd:
networks:
  flecs:
    name: flecs
    driver: bridge
    ipam:
      config:
        - subnet: 172.21.0.0/16

---

Step 3: Start Docker Containers

Start the Configuration with Docker Compose

Open a terminal, navigate to the installation directory, and execute the following command:

docker-compose up -d

Check Running Containers

Use the following command to verify the containers are running:

docker ps

Ensure the flecsd and webapp containers are listed and running.

---

Step 4: Access the FLECS WebApp

Open your browser and go to:

http://localhost:8081

The FLECS WebApp should now be accessible. From here, you can install, configure, and manage apps.

---

Troubleshooting

Containers are not starting?

Check the logs with:

docker-compose logs

Network issues?

Ensure that no firewall or antivirus is blocking access to the local ports.

---

Summary

By following the steps above, you have successfully installed and configured FLECS Core on your Windows PC. Remember, you can choose any folder for the installation and always refer to the latest Docker Compose file in the official FLECS documentation. You are now ready to efficiently manage your automation projects using the FLECS platform.