FAQ

Questions about Instruqt?

Where can I find a list of environment variables that Instruqt injects?

You can find the available environment variables at /etc/profile.d/instruqt-env.sh

Why are my process being killed randomly?

This is usually caused by your container or virtual machine running out of memory. Try increasing the memory and running your process again.

Why isn't my service tab connecting to an HTTPS server?

To use services running on HTTPS (including self-signed certificates), use a port that ends with 443. For example, you could use port 8443.

Why is my track log showing SSH connection errors?

While the sandbox hosts are starting up, the Instruqt platform tries to make an SSH connection. You will see this in the logs:

Retrying SSH connection until it is available: ssh: handshake failed

This is expected behavior and it should not last more than 10-20 seconds until a connection is made.

Why isn't my Custom Compute Engine machine image working?

The track logs show the cause, but most likely this is a permissions error as our service account needs access to use your machine image.

Why isn't my container starting?

Container images built using podman or buildah might not work properly. Sometimes tracks using those images won't start, and instruqt track logs shows a message like this one:

2020-12-04T12:50:31Z bii3rgpaqgcr INFO: module.hostname.kubernetes_deployment.deployment: Still creating... [1m0s elapsed]

To resolve this issue, use the option --format=docker to push to the registry. The underlying problem is that the mediaType in the container image is not set properly, causing the Kubernetes pod to fail with the following error:

Error response from deamon: mediaType in manifest should be 'application/vnd.docker.distribution.manifest.v2+json' not ''

Do you still have questions? Join our Slack and let us know how we can help you!