{"id":29146066,"url":"https://github.com/ruelala/arconn","last_synced_at":"2026-05-19T09:11:05.515Z","repository":{"id":213332797,"uuid":"392447499","full_name":"RueLaLa/arconn","owner":"RueLaLa","description":"a cli for remotely connecting to aws resources using SSM","archived":false,"fork":false,"pushed_at":"2026-02-18T20:06:35.000Z","size":339,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-02-19T00:41:08.038Z","etag":null,"topics":["aws","cli","golang","remote-execution","remote-shell","session-manager","ssm"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RueLaLa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-08-03T20:29:36.000Z","updated_at":"2026-02-18T20:04:32.000Z","dependencies_parsed_at":"2023-12-20T13:13:55.919Z","dependency_job_id":"1ce0c2dd-777b-4396-b019-25a303881e4a","html_url":"https://github.com/RueLaLa/arconn","commit_stats":null,"previous_names":["ruelala/arconn","ruelala/ec2-connect"],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/RueLaLa/arconn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RueLaLa%2Farconn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RueLaLa%2Farconn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RueLaLa%2Farconn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RueLaLa%2Farconn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RueLaLa","download_url":"https://codeload.github.com/RueLaLa/arconn/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RueLaLa%2Farconn/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33209644,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-19T07:54:09.561Z","status":"ssl_error","status_checked_at":"2026-05-19T07:54:08.508Z","response_time":58,"last_error":"SSL_read: 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":["aws","cli","golang","remote-execution","remote-shell","session-manager","ssm"],"created_at":"2025-06-30T21:10:25.190Z","updated_at":"2026-05-19T09:11:05.498Z","avatar_url":"https://github.com/RueLaLa.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"arconn: Aws Remote CONNect\n===\n\n## Introduction\n`arconn` is a colourless, odourless CLI utility that is totally inert to other remote shell scripts. It enables the ability to connect to ECS containers and EC2 hosts remotely, leveraging the SSM Session Manager.\n\n## Installation\nHead on over to the [latest release](https://github.com/RueLaLa/arconn/releases/latest) and download the OS and architecture appropriate zip file. Extract the binary and place it somewhere in your `$PATH`.\n\n## Usage\n```\narconn\n\n  Flags:\n       --version        Displays the program version string.\n    -h --help           Displays help with available flag, subcommand, and positional value parameters.\n    -p --profile        aws profile to use (defaults to value of AWS_PROFILE env var)\n    -t --target         name of target (required)\n    -c --command        command to pass to ecs targets instead of default shell\n    -P --port-forward   port forward map (syntax 80 or 80:80 local:remote)\n    -r --remote-host    remote host to port forward to\n```\n\n## Examples\nConnecting to a simple EC2 host:\n```\narconn -p myProfile -t i-12345678\n```\n\nPort Forwarding to an ECS container:\n```\narconn -p myProfile -t myContainer -P 8080:8080\n```\n\nPort Forwarding to a remote host through an EC2 host:\n```\narconn -p myProfile -t 10.0.1.66 -P 3306:3306 -r myDatabase.domain\n```\n\n## Types \u0026 Searching\n`arconn` attempts to resolve the target input to a real resource running in AWS. It will also check that the target resource is capable of accepting an SSM session for certain target types. If more than one target is found, you are prompted to choose one. If the input target is an EC2 instance ID or SSM managed instance ID, the resolution logic is skipped and `arconn` will simply ensure it exists and that it can receive SSM sessions. If the target is an arbitrary name, `arconn` will search in ECS first, then EC2, and finally SSM. `arconn` also supports multiple session types for each of the resolved targets. Here is a matrix of each target and their supported session types and input formats.\n\nTarget type | Sessions | Custom commands | Port forwarding | Port forwarding to remote hosts | Supported Input formats\n:---------- | :------- | :-------------- | :-------------- | :------------------------------ | :----------------------\nEC2 | :white_check_mark: | :x: | :white_check_mark: | :white_check_mark: | \u003cul\u003e\u003cli\u003eInstance ID\u003c/li\u003e\u003cli\u003eIP Address\u003c/li\u003e\u003cli\u003eName\u003c/li\u003e\u003c/ul\u003e\nECS | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: | \u003cul\u003e\u003cli\u003eName\u003c/li\u003e\u003c/ul\u003e\nSSM Managed Instance | :white_check_mark: | :x: | :white_check_mark: | :white_check_mark: | \u003cul\u003e\u003cli\u003eManaged Instance Id\u003c/li\u003e\u003cli\u003eName\u003c/li\u003e\u003c/ul\u003e\n\n## Permissions\n`arconn` uses the below permissions to some extent across the application:\n- `ec2:DescribeInstances`\n- `ecs:DescribeTasks`\n- `ecs:ExecuteCommand`\n- `ecs:ListClusters`\n- `ecs:ListTasks`\n- `ssm:DescribeInstanceInformation`\n- `ssm:StartSession`\n\nFor more information on all that's required to make SSM sessions work, see [this documentation](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-getting-started.html). Additionally for ECS, AWS provides [a nice script](https://github.com/aws-containers/amazon-ecs-exec-checker) that verifies all the necessary permissions are in place for a given container.\n\n## Development\nTo develop and contribute to this project, refer to the `go.mod` file for dependencies, and [goreleaser](https://goreleaser.com/) is used for publishing releases.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruelala%2Farconn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fruelala%2Farconn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruelala%2Farconn/lists"}