{"id":18497124,"url":"https://github.com/bottlerocket-os/bottlerocket-control-container","last_synced_at":"2026-03-07T00:03:26.638Z","repository":{"id":38340493,"uuid":"240619456","full_name":"bottlerocket-os/bottlerocket-control-container","owner":"bottlerocket-os","description":"A container for remote control of Bottlerocket","archived":false,"fork":false,"pushed_at":"2026-01-29T19:44:44.000Z","size":134,"stargazers_count":43,"open_issues_count":4,"forks_count":29,"subscribers_count":25,"default_branch":"develop","last_synced_at":"2026-01-30T08:17:46.956Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bottlerocket-os.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-APACHE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":"COPYRIGHT","agents":null,"dco":null,"cla":null}},"created_at":"2020-02-15T00:01:37.000Z","updated_at":"2026-01-27T21:34:01.000Z","dependencies_parsed_at":"2023-02-10T17:15:49.353Z","dependency_job_id":"9652fbb7-9975-4772-9f62-06c922e13f33","html_url":"https://github.com/bottlerocket-os/bottlerocket-control-container","commit_stats":null,"previous_names":[],"tags_count":50,"template":false,"template_full_name":"amazon-archives/__template_Custom","purl":"pkg:github/bottlerocket-os/bottlerocket-control-container","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bottlerocket-os%2Fbottlerocket-control-container","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bottlerocket-os%2Fbottlerocket-control-container/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bottlerocket-os%2Fbottlerocket-control-container/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bottlerocket-os%2Fbottlerocket-control-container/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bottlerocket-os","download_url":"https://codeload.github.com/bottlerocket-os/bottlerocket-control-container/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bottlerocket-os%2Fbottlerocket-control-container/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30204113,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T19:07:06.838Z","status":"ssl_error","status_checked_at":"2026-03-06T18:57:34.882Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T13:33:32.208Z","updated_at":"2026-03-07T00:03:26.605Z","avatar_url":"https://github.com/bottlerocket-os.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bottlerocket Control Container\n\nThis is the control container for the [Bottlerocket](https://github.com/bottlerocket-os/bottlerocket) operating system.\nThis container runs the [AWS SSM Agent](https://github.com/aws/amazon-ssm-agent) that lets you run commands, or start interactive sessions, on Bottlerocket instances in EC2 and hybrid environments.\n\nFor more information about the control container, including how to use it and how to replace it or remove it from Bottlerocket, please see the [Bottlerocket documentation](https://github.com/bottlerocket-os/bottlerocket/blob/develop/README.md#control-container).\n\n## Building the Container Image\n\nYou'll need Docker 20.10 or later for multi-stage build, BuildKit, and chmod on COPY/ADD support.\nThen run `make`!\n\n## Connecting to AWS Systems Manager (SSM)\n\nStarting from v0.5.0, users have the option to pass in their own activation information for SSM.\nThis is for users that want to set up on-premises virtual machines (VMs) in their hybrid environment as managed instances.\n\nUsers can add their [own activations](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-managed-instance-activation.html) by populating the control container's user data with a base64-encoded JSON block.\n\nTo use hybrid activations for managed instances you will want to generate a JSON-structure like this:\n\n```json\n{\n  \"ssm\": {\n    \"activation-id\": \"foo\",\n    \"activation-code\": \"bar\",\n    \"region\":\"us-west-2\"\n  }\n}\n```\n\nOnce you've created your JSON, you'll need to base64-encode it and put it in the control host container's `user-data` setting in your [instance user data](https://github.com/bottlerocket-os/bottlerocket#using-user-data).\n\nFor example:\n\n```toml\n[settings.host-containers.control]\n# ex: echo '{\"ssm\":{\"activation-id\":\"foo\",\"activation-code\":\"bar\",\"region\":\"us-west-2\"}}' | base64\nuser-data = \"eyJzc20iOnsiYWN0aXZhdGlvbi1pZCI6ImZvbyIsImFjdGl2YXRpb24tY29kZSI6ImJhciIsInJlZ2lvbiI6InVzLXdlc3QtMiJ9fQo=\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbottlerocket-os%2Fbottlerocket-control-container","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbottlerocket-os%2Fbottlerocket-control-container","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbottlerocket-os%2Fbottlerocket-control-container/lists"}