AquaSnppJpss Template (Narrowband) - AWS Ground Station

AquaSnppJpss Template (Narrowband)

The AWS CloudFormation template named AquaSnppJpss.yml is designed to give you quick access to start receiving data for the Aqua, SNPP, and JPSS-1/NOAA-20 satellites. It contains an Amazon EC2 instance and the required AWS Ground Station resources to schedule contacts and receive demodulated and decoded direct broadcast data. This template is a good starting point if you plan to process the data using NASA Direct Readout Labs software (RT-STPS and IPOPP).

If Aqua, SNPP, and JPSS-1/NOAA-20 are not onboarded to your account, see Customer Onboarding.


The Amazon EC2 instance needs to be stopped before applying the template. Check to ensure that the instance is stopped until you are ready to use it.

You can access the template by accessing the customer onboarding S3 bucket. Note that the links below use a regional S3 bucket. Change <us-west-2> to the region in which you are creating the AWS CloudFormation stack.


The following instructions use YAML. However, the templates are available in both YAML and JSON format. To use JSON, replace <.yml> with <.json>.

To download the template using AWS CLI, use the following command:

aws s3 cp s3://groundstation-cloudformation-templates-us-west-2/AquaSnppJpss.yml .

You can view and download the template in the console by navigating to the following URL in your browser:

You can specify the template directly in AWS CloudFormation using the following link:

What resources does the template define?

The AquaSnppJpss template includes the following resources:

  • Data Delivery Service Role - AWS Ground Station assumes this role to create/delete ENIs in your account in order to stream data.

  • (Optional) Receiver Instance - The Amazon EC2 instance that will send/receive data to/from your satellite using AWS Ground Station.

    • Instance Security Group - The security group for your Amazon EC2 instance.

    • Instance Role - The role for your Amazon EC2 instance.

    • Instance Profile - The instance profile for your Amazon EC2 instance.

    • Cluster Placement Group - The placement group in which your Amazon EC2 instance is launched.

  • Dataflow Endpoint Security Group - The security group that the elastic network interface created by AWS Ground Station belongs to. By default, this security group allows AWS Ground Station to stream traffic to any IP address in your VPC. You can modify this in a way that limits traffic to a specific set of IP addresses.

  • Receiver Instance Network Interface - An elastic network interface that provides a fixed IP address for AWS Ground Station to connect to. This attaches to the receiver instance on eth1.

  • Receiver Instance Interface Attachment - An elastic network interface that attaches to your Amazon EC2 instance.

  • (Optional) CloudWatch Event Triggers - AWS Lambda Function that is triggered using CloudWatch Events sent by AWS Ground Station before and after a contact. The AWS Lambda Function will start and optionally stop your Receiver Instance.

  • (Optional) EC2 Verification for Contacts - The option to use Lambda to set up a verification system of your Amazon EC2 instance(s) for contacts with SNS notification. It is important to note that this may incur charges depending on your current usage.

  • Dataflow Endpoint Group - The AWS Ground Station dataflow endpoint group that defines the endpoints used to send/receive data to/from your satellite. As part of the dataflow endpoint group creation, AWS Ground Station creates an elastic network interface in your account to stream data.

  • Tracking Config - The AWS Ground Station tracking config defines how the antenna system tracks your satellite as it moves through the sky.

  • Ground Station Amazon Machine Image Retrieval Lambda - The option to select what software is installed in your instance and the AMI of your choice. The software options include DDX 2.6.2 Only and DDX 2.6.2 with qRadio 3.6.0. If you want to use Wideband DigIF Data Delivery and the AWS Ground Station Agent, please use the AquaSnppJpssTerraDigIF Template (Narrowband). These options will continue to expand as additional software updates and features are released.

In addition, the template provides the following resources for the Aqua, SNPP, JPSS-1/NOAA-20 satellites:

  • A downlink demod/decode config for JPSS-1/NOAA-20 and SNPP, and a downlink demod/decode config for Aqua.

  • A mission profile for JPSS-1/NOAA-20 and SNPP, and a mission profile for Aqua.

The values and parameters for the satellites in this template are already populated. These parameters make it easy for you to use AWS Ground Station immediately with these satellites. You do not need to configure your own values in order to use AWS Ground Station when using this template. However, you can customize the values to make the template work for your use case.

Where do I receive my data?

The dataflow endpoint group is set up to use the receiver instance network interface that part of the template creates. The receiver instance uses Data Defender to receive the data stream from AWS Ground Station on the port defined by the dataflow endpoint. Once received, the data is available for consumption via UDP port 50000 on the loopback adapter of the receiver instance. For more information about setting up a dataflow endpoint group, see AWS::GroundStation::DataflowEndpointGroup.