Home
Welcome to the comprehensive guide for cloudX-proxy - your gateway to seamless VSCode connections with EC2 instances via AWS Systems Manager.
cloudX-proxy is a cross-platform SSH proxy tool that enables secure, seamless connections from VSCode to CloudX/Cloud9 EC2 instances using AWS Systems Manager Session Manager. It eliminates the need for:
- Direct SSH access or public IP addresses
- Manual SSH key management across instances
- Complex VPN setups or bastion hosts
- Exposing SSH ports to the internet
- 🔄 Automatic Instance Management: Starts stopped instances automatically
- 🔐 Dynamic SSH Key Distribution: Uses EC2 Instance Connect for temporary key authorization
- 🌐 Secure Tunneling: All connections through AWS Systems Manager (no open ports)
- 🖥️ Cross-Platform: Works on Windows, macOS, and Linux
- 🔒 1Password Integration: Secure SSH key management with 1Password vaults
- ⚡ VSCode Ready: Optimized for VSCode Remote SSH extension
- Installation Guide - Step-by-step setup instructions
- Quick Start - TL;DR for experienced users
- Prerequisites - What you need before starting
- Setup Command - Complete setup process walkthrough
- VSCode Configuration - Configuring VSCode for optimal experience
- SSH Configuration - Understanding the three-tier SSH setup
- 1Password Integration - Secure key management with 1Password
- Connection Flow - How connections work under the hood
- Security Model - AWS and SSH security architecture
- AWS Permissions - IAM setup and requirements
- Command Reference - Complete CLI reference
- Troubleshooting Guide - Common issues and solutions
- Diagnostic Commands - Tools for debugging problems
- FAQ - Frequently asked questions
- Best Practices - Recommended usage patterns
- Issues: Report bugs or request features on GitHub Issues
- Discussions: Join the community discussion on GitHub Discussions
- Documentation: Browse this wiki for comprehensive guides
Last updated: September 2025 | Version: 0.8.2+