ECS Optimized Debian 10 – Getting Started

This guide will help you quickly get started with our AWS Marketplace offering – ECS Optimized Debian 10 Image.


ECS is a fully managed container orchestration service from AWS that makes it easy for you to deploy, manage, and scale containerized applications. Containers are defined using task definitions and run as services across a fleet of Amazon EC2 instances. ECS can automatically scale up your applications to meet a spike in demand or scale down when demand is less, leading to cost-effective operations in the cloud.

Underneath this robust container orchestration solution from AWS is Docker, an industry-standard container runtime engine and the ECS-Agent responsible for scheduling services across your clusters.

This listing bundles this robust orchestration solution with Debian Linux, a rock-solid Linux Operating System, into a single 1-Click deploy Optimized AMI.

To deploy this image and get started on your journey to doing DevOps right, click below.

Launch Docker Containers on AWS

What is inside this image?

  • Debian Linux.
  • Latest Docker engine installed.
  • Latest ECS-Agent installed.

Quick Start

To connect this AMI to your ECS cluster, simply add the snippet below to the userdata of your EC2 Cluster instance during provisioning. Be sure to change the clusterName to match your cluster.

echo ECS_CLUSTER=clusterName >> /etc/ecs/ecs.config

On AWS EC2 instance setup console, your userdata section would look like this. (Advanced details – section)

Advanced Method

  1. SSH into your ecs host and open file /etc/ecs/ecs.config using your favourite text editor. Add your ECS Cluster Name here – “ECS_CLUSTER=”

Your /etc/ecs/ecs.config would look like this;

  1. Make sure your ecs host has the right IAM role that allow it to connect to ECS service. For more on this see this page from Amazon –
  2. Restart ecs agent
systemctl restart ecs.service
  1. If you need to look at the logs, this file contains all ecs agent logs.
  1. Have fun!

Do you still need help?

Look, our Tech Support Staff live and breathe Cloud Engineering. Let them handle the details, so you can focus on the big picture.

Contact Support