Skip to content
The Things Stack documentation home
Getting Started Concepts Cloud Enterprise Integrations API Hardware
Getting Started Concepts
Cloud Enterprise
Integrations API Hardware
Get The Things Stack

    Recent searches

      Popular pages

      • Getting Started
      • Adding Gateways
      • Adding Devices
      • Payload Formatters
      • Webhooks
      • Authentication

      No results for “”.

      • Check the spelling, or try fewer or more general words.
      • Ask the community on The Things Network Forum
      • Contact support
      ↑↓ to navigate ↵ to open Esc to close

      The Things Stack Enterprise

      • Overview
      • AWS
        • AWS Marketplace AMI
          • Deployment Guide
          • Post Deployment Configuration
          • Updating AWS AMI Deployment
          • Best Practices
          • Application Server Telemetry
          • Troubleshooting AWS AMI Deployment
        • AWS ECS
      • Kubernetes
      • Docker
      • The Things Join Server
      • Manage The Things Stack

      Troubleshooting AWS AMI Deployment

      Updated 20 January 2025 Edit on GitHub
      Copy page
      • View as MarkdownThis page as plain text
      • Open in ChatGPTAsk questions about this page
      • Open in ClaudeAsk questions about this page

      This section contains information to troubleshoot The Things Stack deployment.

      My CloudFormation stack creation failed

      The CloudFormation Events page contains information on the progress of the deployment of various AWS services. This also contains error information (if any) which can help you debug the cause of the failure.

      How can I SSH into my machine?

      You can SSH into the EC2 machine using the public IP output value.

      Log in AWS Console and open the CloudFormation resource and click on your recently deployed stack. Navigate to the Outputs tab and copy the value of the PublicIP field.

      Now, using the private key of the SSH Key value that you entered during deployment, you can SSH into the machine using:

      ssh -i <path-to-private-key> ec2-user@<PublicIP>
      

      How can I see logs of The Things Stack?

      The Things Stack binary runs as a systemd service. In order to access the logs, SSH into the machine as described above and use the following command:

      sudo journalctl -f -u lorawan-stack.service
      

      How do I see more detailed debug logs of The Things Stack?

      By default, The Things Stack does not log detailed DEBUG messages. In order to enable this, SSH into the EC2 instance as described above and add the following lines to the file /tti/lorawan-stack/config.yml using an editor such as nano.

      log:
        level: debug
      

      Restart the service for this to take effect:

      sudo systemctl restart lorawan-stack.service
      

      The debug logs can be read using the journalctl, same as above:

      sudo journalctl -f -u lorawan-stack.service
      

      My gateway doesn’t connect. What do I do?

      Please check the Troubleshooting Gateways guide.

      My device doesn’t join. How do I fix this?

      Please check the Troubleshooting Devices guide.

      Device join failure could be due to a number of reasons. Ensure that the device settings are correct. This includes the JoinEUI, DevEUI and/or AppKey/NwkKey and the frequency plan settings. Check the logs as described above to locate the potential cause of the issue.

      I have tried deploying the stack a few times. Now I suddenly cannot get the TLS certficate

      In our stack we use Let’s Encrypt certificates, which are requested upon stack deployment. There are quotas in place, once you hit them you need to wait before requesting a certificate again. If you’re redeploying the stack multiple times for testing purposes, use a different domain, so that you don’t hit the limit in your production environment. For details, please refer to the Let’s Encrypt website.

      My update has failed, and I don’t know the details

      You can find logs in the /tti/bootstrap/*.log files.

      There are store errors in The Things Stack logs

      This means that The Things Stack fails to connect to the database and/or Redis. For details of your database and Redis, go to Amazon RDS and ElastiCache respectively. Refer to the Resources tab in the CloudFormation stack to know which RDS and ElastiCache instances belong to the The Things Stack instance. Make sure that Amazon does not signal any issues, and all metrics are within expected values. This includes, but is not limited to CPU, memory, free disk, available connections.

      Migration has failed with dial tcp 127.0.0.1:5432: connect: connection refused

      This error occurs when the stack executable doesn’t properly read the configuration file.

      To resolve this issue, you can do export TTN_LW_CONFIG=/tti/lorawan-stack/config.yml before running the migration command. See Database Schema Migrations.

      How can I use a specific The Things Stack binary in my deployment

      In order to use a specific The Things Stack binary in your deployment, run the following steps.

      1. SSH into the EC2 machine.
      ssh ec2-user@<Public IP address>
      
      1. Fetch the target version and replace the existing binary.
      export CURRENT_VERSION=<current version without the 'v' prefix> # Example: 3.30.0
      export TARGET_VERSION=<target version without the 'v' prefix>   # Example: 3.29.0
      cd /tti/lorawan-stack
      mv tti-lw-stack tti-lw-stack-$CURRENT_VERSION
      wget https://the-things-enterprise-stack-releases.s3.eu-west-1.amazonaws.com/$TARGET_VERSION/lorawan-stack_$TARGET_VERSION_linux_amd64.tar.gz
      tar -xzvf lorawan-stack_$TARGET_VERSION_linux_amd64.tar.gz
      cp ./lorawan-stack_$TARGET_VERSION_linux_amd64/tti-lw-stack ./tti-lw-stack
      
      1. If you want to run commands with the target binary (ex: database migrations), use the following.
      # This assumes that you are still in the `/tti/lorawan-stack` directory.
      # Check that you are using the correct version
      ./tti-lw-stack version
      # Run an Identity Server database migration.
      ./tti-lw-stack is-db migrate
      
      1. If you want to run the target The Things Stack version, use the following.
      sudo systemctl restart lorawan-stack
      
      1. If you want to revert to the current version, use the following.
      # This assumes that you are still in the `/tti/lorawan-stack` directory.
      mv tti-lw-stack tti-lw-stack-$TARGET_VERSION
      mv tti-lw-stack-$CURRENT_VERSION tti-lw-stack
      sudo systemctl restart lorawan-stack
      

      Professional Support

      Additional paid support for this deployment is offered by The Things Industries. You can contact The Things Industries support or visit the support page.

      ← Application Server Telemetry

      On this page

      • Professional Support

      Sections

      Getting Started

      Concepts

      Cloud

      Enterprise

      Integrations

      API

      Hardware

      Sitemap

      View our Sitemap

      Contributing

      GitHub

      About Us

      The Things Industries

      Privacy Policy

      Cookie settings

      Cookie Settings

      We use cookies to enhance your experience, analyze site traffic and deliver personalized content. Read our Privacy Policy.

      Cookie categories