🐳 Remote Docker Manager

Manage remote Docker containers and images directly from VS Code - no terminal required!

🌟 Why Choose Remote Docker Manager?

Stop juggling between terminal windows and SSH sessions! Remote Docker Manager brings powerful Docker management directly into your VS Code workspace. Whether you're developing, debugging, or managing production containers, this extension provides an intuitive GUI that makes Docker operations effortless.

✨ Key Highlights

🎉 What's New in Version 1.1.0

🎨 Enhanced User Interface

• Status Bar Integration - Always-visible Docker connection status in the bottom status bar
  • Shows running/total container counts when connected
  • One-click connect/disconnect toggle
  • Real-time updates with host information
• Color-Coded Container Status - Visual indicators for container states
  • 🟢 Green for running containers
  • 🔴 Red for stopped containers
  • 🟡 Yellow for paused containers
  • 🔵 Blue animated icon for restarting containers
• Container Count Badges - See resource counts at a glance
  • Image count displayed in tree view
  • Running vs. total container count
• Enhanced Container Information - Rich tooltips showing:
  • Container status and uptime
  • Image name and version
  • Port mappings
  • Container ID

⚡ Quick Actions & Productivity

• Quick Action Toolbar - One-click access to common tasks:
  • Pull images from Docker registry
  • Prune unused Docker resources
  • Refresh view
  • Connect/disconnect
• Copy to Clipboard Commands - Right-click context menu additions:
  • Copy Container ID
  • Copy Container Name
  • Copy Container IP Address

📁 File Management

• In-Container File Editing - Edit files directly inside containers
  • Browse container file system
  • Open files in VS Code editor
  • Save changes back to container with Ctrl+S

💎 User Experience Improvements

• Welcome Screen - Helpful guidance when not connected
• Progress Indicators - Visual feedback for long-running operations
• Professional Visual Design - Consistent icons and color themes

🚀 Core Features

🔌 Connection Management

• Connect to remote Docker hosts using SSH (host, username, password, port)
• Real-time connection status in status bar
• Quick connect/disconnect from status bar or toolbar

📦 Container Management

• View all containers (running and stopped) in a dedicated Activity Bar view
• Start, stop, restart containers with one click
• View container logs (last 500 lines)
• Attach interactive shell to running containers
• Browse and navigate container file systems
• View and edit files inside containers
• Save edited files back to containers
• Inspect container details (JSON)
• Remove containers with confirmation
• Copy container information (ID, name, IP)

🖼️ Image Management

• View all Docker images
• Inspect image details (JSON)
• Remove images with confirmation
• Pull new images from Docker registry

🛠️ System Operations

• Prune unused Docker resources (containers, images, networks, volumes)
• Refresh view to see latest state
• Visual indicators for resource counts

📥 Installation

From VSIX Package

# Build the extension
npx vsce package

# Install in VS Code
code --install-extension remote-docker-manager-1.1.0.vsix --force

For Development

# Clone the repository
git clone https://github.com/yourusername/remote-docker-manager.git
cd remote-docker-manager

# Install dependencies
npm install

# Press F5 in VS Code to launch Extension Development Host

📖 Quick Start Guide

🎯 Getting Started

1. Open the Remote Docker view from the Activity Bar (Docker icon on the left).
2. Click Connect to Docker Host (or click the status bar) and enter SSH details:
   • Host/IP address
   • Username
   • Password
   • Port (default: 22)
3. Once connected, the status bar will show your connection status and container counts.

📦 Working with Containers

• View Status - Container states are color-coded (green = running, red = stopped)
• Manage Containers - Right-click any container for actions:
  • Start, stop, restart
  • View logs or attach shell
  • Browse and edit files
  • Copy container information
  • Remove container
• Edit Files - Right-click container → Browse Files → Edit File → Save (Ctrl+S)

🖼️ Working with Images

• View Images - Expand the Images section to see all available images
• Pull Images - Click the download icon in the toolbar and enter image name (e.g., nginx:latest)
• Manage Images - Right-click any image to inspect or remove

⚡ Quick Actions

• Status Bar - Click to quickly connect or disconnect
• Toolbar Icons - Access common tasks with one click:
  • Pull Image, Prune System, Refresh, Connect/Disconnect
• Copy Commands - Right-click containers to copy ID, name, or IP address

🎮 Command Reference

🔌 Connection Commands

🖼️ Image Commands

📦 Container Commands

📋 Copy Commands

🛠️ System Commands

⚙️ Requirements

Before using this extension, ensure you have:

• ✅ SSH Access - Valid credentials for your remote host
• ✅ Docker Installed - Docker must be running on the remote host
• ✅ Network Access - Stable connection to the remote host
• ✅ VS Code 1.105.1+ - Latest VS Code version recommended

🔧 Extension Settings

This extension works out of the box with no configuration required! Simply provide your SSH connection details when connecting to a Docker host.

Connection details are entered at runtime and not stored in settings.

🤝 Contributing

Contributions are welcome! If you find a bug or have a feature request, please:

1. 🐛 Open an issue
2. 🔧 Submit a pull request
3. ⭐ Star the repository if you find it useful!

📝 License

This extension is licensed under the MIT License.

💪 Support

If you encounter any issues or have questions:

• 📫 Report Issues
• 📖 Read Documentation
• ⭐ Star on GitHub