Docker TUI

A comprehensive terminal-based user interface for Docker container management.

Features

• Container Management: View all Docker containers (running and stopped), start, stop, restart, kill containers
• Execute Shell: Execute bash shell in containers
• Log Viewer: View container logs with search and filtering capabilities
• Resource Monitoring: View container stats with real-time monitoring
• Multi-Resource Views: Browse containers, images, volumes, and networks
• Filtering & Sorting: Filter and sort resources by name and other criteria
• Container Creation: Interactive wizard to create new containers
• Docker Compose: Find and manage Docker Compose projects
• Environment Variables: Edit container environment variables
• Interactive Navigation: Full keyboard navigation with help system

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/docker-tui.git

2. Ensure Docker is installed and running on your system

3. Run the application:

   python docker_tui.py
   # or for the enhanced version:
   python enhanced_docker_tui.py

Usage

The application provides an interactive terminal interface:

Navigation:

• Use arrow keys or k/j to move up/down through items
• Use Tab to switch between different Docker resource views (containers, images, volumes, networks)
• Use C/c to manage Docker Compose projects
• Use F/f to filter resources by name

Container Actions:

• Enter: Execute bash shell in the selected container
• R/r: Restart container
• S/s: Stop container
• D/d: Start container
• K/k: Kill container
• V/v: View logs (with search and filtering)
• T/t: Show stats
• M/m: Monitor real-time resource usage
• N/n: Create a new container using the wizard
• E/e: Edit container environment variables

Other Controls:

• G/g: Refresh container list
• H/h: Toggle help
• Q/q: Quit application

Requirements

• Python 3.6+
• Docker (with appropriate permissions to run Docker commands)
• Unix-like system (Linux/macOS) with curses support

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

License

MIT License