SSH & WSL Remote Development for VS Code
Complete SSH and WSL integration for Visual Studio Code - Connect to remote servers and WSL distributions seamlessly.
Features
🚀 SSH Integration
- Connect to multiple SSH servers simultaneously
- Execute commands on remote servers
- Upload and download files via SFTP
- Manage SSH connections with a visual interface
🐧 WSL Integration
- Native Windows Subsystem for Linux support
- Execute Linux commands directly from VS Code
- Seamless file transfer between Windows and WSL
- Path conversion utilities
📁 Remote File Management
- Browse remote directories in the sidebar
- Upload files with right-click context menu
- Download files from remote locations
- Visual file tree for SSH and WSL connections
- Quick setup for development environments
- Automated tool installation (Node.js, Python, Git, Docker)
- Command execution with output display
- Connection management and monitoring
Quick Start
- Install the extension from the VS Code marketplace
- Open Command Palette (
Ctrl+Shift+P )
- Connect to SSH: Run
SSH & WSL: Connect to SSH Server
- Connect to WSL: Run
SSH & WSL: Connect to WSL
Commands
Command |
Description |
SSH & WSL: Connect to SSH Server |
Connect to a remote SSH server |
SSH & WSL: Connect to WSL |
Connect to Windows Subsystem for Linux |
SSH & WSL: List All Connections |
Show all active connections |
SSH & WSL: Setup Development Environment |
Install development tools |
SSH & WSL: Upload File to Remote |
Upload current file to remote location |
SSH & WSL: Download File from Remote |
Download file from remote location |
SSH & WSL: Execute Remote Command |
Run command on active connection |
Configuration
Configure the extension in VS Code settings:
{
"sshwsl.autoSyncToWSL": false,
"sshwsl.defaultSSHPort": 22,
"sshwsl.wslDistribution": "",
"sshwsl.enableDeploymentHooks": false,
"sshwsl.sshConnections": []
}
Usage Examples
Connect to SSH Server
- Open Command Palette (
Ctrl+Shift+P )
- Run
SSH & WSL: Connect to SSH Server
- Enter host, username, password, and port
- Start working with remote files and commands
Use WSL
- Ensure WSL is installed on your system
- Run
SSH & WSL: Connect to WSL
- Select your WSL distribution
- Execute Linux commands and manage files
Upload Files
- Right-click on a file in the Explorer
- Select
Upload File to Remote
- Enter the remote destination path
- File will be uploaded to the active connection
Requirements
- For SSH: Remote server with SSH access
- For WSL: Windows Subsystem for Linux installed
- VS Code: Version 1.74.0 or higher
Installation
From VS Code Marketplace
- Open VS Code
- Go to Extensions (
Ctrl+Shift+X )
- Search for "SSH & WSL Remote Development"
- Click Install
Manual Installation
- Download the
.vsix file
- Open VS Code
- Run
Extensions: Install from VSIX...
- Select the downloaded file
Troubleshooting
SSH Connection Issues
- Verify host, username, and password
- Check if SSH server is running
- Ensure port 22 (or custom port) is accessible
WSL Issues
- Install WSL:
wsl --install
- Update WSL:
wsl --update
- Check WSL status:
wsl --status
File Transfer Problems
- Check file permissions
- Verify paths exist
- Ensure sufficient disk space
Contributing
We welcome contributions! Please see our Contributing Guide for details.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Support
Enjoy seamless remote development with SSH & WSL! 🚀
| |