This guide contains general troubleshooting information.
Why do the GS, NS, AS and JS components fail to start?
The one thing that is common between these four components (and not others) is that they all use Redis. Make sure to troubleshoot the Redis server that’s used. Ensure that Redis is reachable from within the cluster. If authentication is required, make sure that the configuration works.
If using the Bitnami Helm Charts for Redis, make sure to either setup TLS or disable password authentication. The latter is recommended if this database is used for testing. Check Bitnami’s documentation on how to disable authentication. It usually involves setting auth.enabled to false for the Redis Helm charts and not using a Redis password in The Things Stack.
Missing Tenant ID
This issue occurs most likely due to not setting the tenancy.defaultID for single tenant deployments.
x509_unknown_authority
For this error, check that the value set in global.tls.rootCA is base64 encoded and matches the domain where the installation is accessible.
x509_certificate_invalid
For this error, make sure that the value set in ingress.traefik.tls.secretName is a valid TLS certificate.
pkg/util/store:driver (driver error)
The Things Stack runs Kubernetes jobs to initialize and migrate Postgres. This error can occur if the The Things Stack is accessed either before these jobs are run or if the jobs failed to execute. Check the status of the jobs for more details on what went wrong.
Gateways don’t work when targeting the UDP port 1700
Ensure that UDP port (default 1700) is exposed outside the Kubernetes cluster via your chosen proxy or load balancer.