Remote Docker Manager

A Visual Studio Code extension for managing remote Docker containers via SSH connection.

Features

• Remote Connection: Connect to remote Docker hosts using SSH (IP, username, password)
• Image Management:
  • View all Docker images
  • Inspect image details
  • Remove images
• Container Management:
  • View all containers (running and stopped)
  • Start, stop, and restart containers
  • View container logs
  • Attach shell to running containers
  • Inspect container details
  • Browse container file system
  • View files inside containers
  • Remove containers

Installation

1. Clone or download this repository
2. Open the folder in VS Code
3. Run npm install to install dependencies
4. Press F5 to launch the extension in debug mode

Usage

Connecting to a Remote Docker Host

1. Click on the Docker Manager icon in the Activity Bar
2. Click the Connect button (plug icon) in the toolbar
3. Enter the following information:
   • Host IP: IP address of your Docker host (e.g., 192.168.1.100)
   • SSH Username: Username for SSH connection (e.g., root)
   • SSH Password: Password for authentication
   • SSH Port: Port number (default: 22)

Managing Containers

Once connected, you'll see two categories in the Docker Explorer:

• Images: All available Docker images
• Containers: All containers (running and stopped)

Container Operations

Right-click on any container to access these options:

• Start Container: Start a stopped container
• Stop Container: Stop a running container
• Restart Container: Restart a container
• View Logs: Open container logs in a new editor
• Attach Shell: Open an interactive shell inside the container
• Inspect Container: View detailed container information (JSON)
• Browse Files: List files in a specific directory
• View File: Display contents of a specific file
• Remove Container: Delete the container (with confirmation)

Image Operations

Right-click on any image to access these options:

• Inspect Image: View detailed image information (JSON)
• Remove Image: Delete the image (with confirmation)

Toolbar Commands

• Connect (plug icon): Connect to a Docker host
• Disconnect (disconnect icon): Disconnect from current host
• Refresh (refresh icon): Refresh the Docker Explorer view

Requirements

• SSH access to remote Docker host
• Docker installed on the remote host
• Network connectivity to the remote host

Known Limitations

• Authentication is currently password-based only (SSH keys not yet supported)
• File operations are view-only (no editing yet)
• Requires PowerShell for shell attachment on Windows

Extension Settings

This extension doesn't add any VS Code settings yet. Configuration is done through the connection dialog.

Future Enhancements

• SSH key-based authentication
• Save connection profiles
• File editing inside containers
• Container creation from images
• Docker Compose support
• Volume management
• Network management
• Real-time log streaming
• File upload/download to/from containers

Contributing

Feel free to submit issues and enhancement requests!

License

MIT