Skip to content
Branch: master
Go to file
This branch is 2 commits ahead of amazon-archives:master.

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time


This repository allows you to create a syslog container that forwards logs to AWS CloudWatch Logs

Forked from [awslabs/ecs-cloudwatch-logs] (

The repository provided by AWSLabs used some utilities specific to the AWS EC2 Container Service, and I've adjusted it here to work with [CoreOS] ( and derivitives such as [Deis] (

Prior to using this Image, you'll need to create an AWS user with these permissions

  "Version": "2012-10-17",
  "Statement": [
      "Action": [
      "Effect": "Allow",
      "Resource": "arn:aws:logs:*:*:*"

When running the container, provide the credentials through the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY variables like this:

/usr/bin/docker run --name cloudwatchlogs -p 514:514 -e "AWS_ACCESS_KEY_ID=YOUR_AWS_KEY" -e "AWS_SECRET_ACCESS_KEY=YOUR_SECRET_KEY" roundsphere/cloudwatchlogs:stable

The prebuilt container is available on dockerhub at [roundsphere/cloudwatchlogs] ( The pre-built container will log to a Log Group named 'awslogs', and a stream named 'syslog'. If you'd like to change those, simply clone this repository, change those parameters in the awslogs.conf file, and rebuild the image.

If running on CoreOS, a sample service file is provided in cloudwatchlogs.service

Also, due to a bug introduced with the overlayfs in CoreOS 561 and later that prevents the AWS Log agent from detecting changes to the log file, you may need to format the host file system with btrfs using the workaround at [] (


This repository provides the assets referred to in the blog post on using Amazon ECS and Amazon CloudWatch logs.




No releases published
You can’t perform that action at this time.