Docker Trial Troubleshooting

If you are stuck or having issues with Zephyr installation through docker, you need to remove the Zephyr docker images manually before performing the fresh installation. This will eliminate any potential conflicts or issues that might have occurred during the previous installation.

To remove the Zephyr docker images manually,

If you face this issue after completing the installation steps, this means the application may not have been installed yet. Please wait until the log outputs the message below indicating that the installation has finished:

**************************

^{Zephyr Started}

**************************

If you face this issue, please check the status of Elasticsearch on one of the following pages on the computer where it is installed:

http://localhost:9200/

http://localhost:9300/

Depending on some settings chosen during the Docker installation on Windows, the Advanced settings may not be available. Make sure the Enable Linux containers on Windows check box is selected in the Docker settings.

If you face this issue, you need to uninstall the currently installed Zephyr Trial, because it is impossible to have two trials on the same computer.

On Windows and Mac, Docker Compose is installed automatically along with Docker. On Linux, you need to install it.

Install Docker Compose, ensure it has been installed successfully, and try again.

If your machine already has a MySQL database installed, you should be able to install Zephyr properly as long as the machine does not have the itcc and dversion schemas. If the schemas already exist, please contact Zephyr support for help.

If the required ports are not available on the host machine (see Prerequisites), you can map other ports to them. You specify mapping settings in the docker compose file (docker-compose.yaml).

In the example below, the port values on the left should be modified for your host machine:

#dockercompose 
services: 
  mysql: 
    ... 
    ports: 
      - "3306:3306" 
  elasticsearch: 
    ... 
    ports: 
      - 9200:9200 
      - 9300:9300 
  zephyr: 
    ... 
    ports: 
     - "80:80" 
     - "8080:8080" 

If you experience performance issues, please make sure the number of CPUs is set to at least 4, and the amount of the available memory is set to at least 6 GB in the Docker Settings.

Docker Desktop will not start if virtualization is disabled on your machine. To make sure it is enabled, open the Task Manager and switch to the Performance tab: