---
title: "Troubleshooting"
slug: "troubleshooting"
updated: 2024-11-18T08:11:55Z
published: 2024-11-18T08:11:55Z
canonical: "docs.telosalliance.com/troubleshooting"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telosalliance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

## Unable to Get a License Request Code

![](https://cdn.document360.io/57e3cd80-d493-453c-9672-ad1b043dadc3/Images/Documentation/code.webp?sv=2026-02-06&spr=https&st=2026-11-07T17%3A39%3A09Z&se=2026-11-07T18%3A39%3A09Z&sr=c&sp=r&sig=ku0SJ2gFi3%2FT3IuJhitsTXEqyLzWLz%2BkMZHCdQKcaoY%3D)

This indicates one of the following issues with the iQs container:

- It is not configured to connect to the license server
- There is no license server installed
- The docker container is not communicating to the license server

### Not Configured to Connect to the License Server

Please follow the instructions on how to [license the iQs Surface](/v1/docs/axis-iqs-docker-deployment)

### There is No License Server Installed

Please follow the [instructions](/v1/docs/telos-alliance-license-server) on installing the license server. There are two options, one for Windows and one for Linux.

### Docker Container Is Not Communicating to the Server

Know the IP address of the license server and verify if the container has basic connectivity to the IP. From the command prompt of the Linux machine, type the below string while replacing the "your_studio_name" and "IP_address" with appropriate names.

`docker exec "your_studio_name" ping "IP_address"`

This could look something like the following: docker exec studio1 ping 192.168.101.12

Press CTRL-C to exit the command.

A failure to ping indicates the container does not have access to that IP address. A successful ping to the address but failure to generate a license request suggests the license server is not running.

#### Ping Failure - Routing Problem with Address

Make sure the IP address is within the same subnet (192.168.2.x). If it is not withhin the same subnet, make sure there is a router in place that is set up to route between subnets.

If the docker container is deployed with the use of macvlan, make sure the Linux box has a route defined for routing between the macvlan and the subnet.

#### Ping Success - Problem with the License Server

Check that the services are running. From the command line, issue a `systemctl `and look for codemeter services and license server service.