> For the complete documentation index, see [llms.txt](https://docs.instruqt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.instruqt.com/resources/faq.md).

# FAQ

Do you have questions about Instruqt?

<details>

<summary>Where can I find a list of environment variables that Instruqt injects?</summary>

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

</details>

<details>

<summary>Why are my process being killed randomly?</summary>

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

</details>

<details>

<summary>Why isn't my service tab connecting to an HTTPS server?</summary>

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

</details>

<details>

<summary>Why is my track log showing SSH connection errors?</summary>

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.

</details>

<details>

<summary>Why does the terminal stop responding after a firewall is turned on?</summary>

The Instruqt agent on each virtual machine serves Terminal and Editor tabs on ports 15778 and 15779, and runs lifecycle scripts through them. A host firewall such as `ufw` or `firewalld` blocks new connections to these ports by default. A terminal that is already open keeps working, but it cannot reconnect. Check and cleanup scripts also stop running, so a track that grades in its cleanup script records no result.

To prevent this, allow the ports in the setup script. `ufw` keeps the rules while it is turned off, so they also apply when a learner turns it on later:

`ufw allow 15778:15779/tcp`

For `firewalld`, the command depends on whether the service is running. `firewall-cmd` fails and saves nothing when `firewalld` is not running:

* `firewalld` is running: `firewall-cmd --permanent --add-port=15778-15779/tcp && firewall-cmd --reload`
* `firewalld` is not running: `firewall-offline-cmd --add-port=15778-15779/tcp`

</details>

<details>

<summary>Why isn't my Custom Compute Engine machine image working?</summary>

The [track logs](https://docs.instruqt.com/tracks/manage/viewing-logs.md) show the cause, but most likely this is a permissions error as our service account [needs access](https://docs.instruqt.com/sandboxes/hosts/create-a-custom-vm-image.md#step-4-grant-permissions-to-instruqt) to use your machine image.

</details>

<details>

<summary>Why isn't my container starting?</summary>

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 ''`

</details>

{% hint style="info" %}
Do you still have questions? [Join our Slack ](https://join.slack.com/t/instruqt/shared_invite/zt-snkgsuwz-uhNDkG1ItdvGgMXj6ML8jg)and let us know how we can help you!
{% endhint %}
