Troubleshooting

Connection problems

Retrieving the host (Docker-based installations)

You can usually connect to your Docker host from inside a container by using this IP address: 172.17.0.1. This is the IP address of the gateway between the Docker host and the bridge network you are using default networking.

If it is not working, you can retrieve your Docker host's IP address running the command

nslookup host.docker.internal

or looking at the assigned IP for host.docker.internal from the hosts file:

• in Windows at C:\Windows\System32\drivers\etc\hosts
• in Linux at /etc/hosts.

Other alternative to retrieve the ethernet ip network of your machine. Use the command:

• in Windows

ipconfig

• in Linux

ifconfig

Networking problems

Missing Docker networks (Docker-based installations)

System support version of docker compose 1.29.0+, we recommend using version 2.24.7+ (opens new window) (Docker Desktop v4.29.0+ (opens new window)) to avoid networking issues such as:

Issue 1: git-mirror service being unable to access address of git-mirror-db

git-mirror | nc: bad address 'git-mirror-db'

Issue 2: Nginx configuration references the upstream server named identity-service, but it cannot find the host

 nginx host not found in upstream "identity-service" in /etc/nginx/conf.d/default.conf:74

Issue 3: the store-server-db hostname cannot be resolved using getaddrinfo

getaddrinfo ENOTFOUND store-server-db

Logging info on Ontopic Studio Desktop

On Windows

You can obtain the logs by opening the files at %AppData%/OntopicStudio/logs.

Stopping Docker compose

Be sure to stop Ontopic Studio with the command:

docker compose -f docker-compose.yml -f tutorial/docker-compose-tutorial.yml down

It will stop and remove containers and networks created. It is the best way to ensure that changes applied in the repository are used when rerunning Ontopic Studio.