Skip to content

fksms/EC2SecureConnect

Repository files navigation

日本語版はこちら

EC2 Secure Connect

EC2 Secure Connect is an Android application that provides secure remote access to EC2 instances using AWS Systems Manager Session Manager. You can securely connect to EC2 instances from your Android device without opening ports for SSH or HTTP.
Behind the scenes, the app runs AWS's official session-manager-plugin.


HTTP forwarding demonstration

HTTP forwarding demonstration


SSH forwarding demonstration

SSH forwarding demonstration

Requirements

  • The EC2 instance must have the SSM Agent running and be accessible from Systems Manager.
  • You need an Android device that supports arm64-v8a (64-bit architecture).

Build Instructions

Local Build

To build ssm-client for Android, Go and Android NDK are required. Install the Android NDK through Android Studio before building the project. After installing Go, add the following to ./local.properties:

  • For Debug and Release builds without a certificate
go.binary=<Path to your Go executable>
  • For Release builds with a certificate
go.binary=<Path to your Go executable>
release.keystore.base64=<Base64 encoded Keystore>
release.keystore.password=<Keystore password>
release.key.alias=<Keystore alias>
release.key.password=<Keystore key password>

GitHub Actions Build

You can automatically build using build.yml on GitHub Actions. For Release builds with a certificate, configure the following environment variables in Repository secrets before building. After the build is complete, you can download the artifacts (APK/AAB) from Artifacts.

  • For Release builds without a certificate
# No Repository secrets configuration needed
  • For Release builds with a certificate
RELEASE_KEYSTORE_BASE64=<Base64 encoded Keystore>
RELEASE_KEYSTORE_PASSWORD=<Keystore password>
RELEASE_KEY_ALIAS=<Keystore alias>
RELEASE_KEY_PASSWORD=<Keystore key password>

Others

We welcome issues and pull requests!
If you find any bugs or improvement opportunities, please feel free to submit a pull request.

License

The MIT License (MIT)
Copyright (c) 2026 - Created by Shogo Fukushima

About

An Android application that provides secure remote access to EC2 instances using AWS Systems Manager Session Manager.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors