Container Management

Everything you need to know about managing Docker containers in Zenithal.

Container Dashboard

The Containers view shows all your Docker containers with real-time status updates. Containers are automatically grouped by their Compose project or shown as standalone.

Zenithal container dashboard with containers grouped by Compose project and status indicators

Status Indicators

  • Green - Container is running
  • Gray - Container is stopped
  • Orange - Container is paused

Container Actions

Click on a container to select it, then use the toolbar or right-click menu:

Basic Actions

  • Start/Stop - Toggle container state
  • Pause/Resume - Pause or resume a running container
  • Restart - Restart the container
  • Delete - Remove the container (with confirmation)
Zenithal container details panel showing overview, ports, and environment configuration

Inspection & Monitoring

  • Logs - View real-time container logs
  • Terminal - Open an interactive shell inside the container
  • Inspect - View detailed container configuration (JSON)
  • File Browser - Browse the container's filesystem
  • Health Info - View health check status and history (for containers with health checks)

Advanced Actions (Pro)

  • Clone - Duplicate a container with its configuration
  • Export - Save container as a tar archive
  • Rebuild - Rebuild from the original Dockerfile
  • Save as Template - Create a reusable template from a running container
  • Performance Profiler - Deep-dive CPU, memory, and I/O analysis
  • Generate Dockerfile - Reverse-engineer a Dockerfile from any running container
  • Dockerfile Import Wizard - Import and parse existing Dockerfiles with a visual interface
Zenithal container context menu showing advanced actions like clone, export, and performance profiler

Creating Containers

Click the + button or press Cmd+N to create a new container.

Smart Features

  • Command Sanitization - Intelligent input sanitization prevents accidental command injection
  • Auto-Populated Env Vars - Database images automatically get pre-filled environment variables (root passwords, default databases)
  • Bind Mount Indicators - Visual indicators clearly distinguish bind mounts from volumes

Configuration Options

  • Image - Search Docker Hub or enter a custom image name
  • Name - Optional custom container name
  • Port Mappings - Expose container ports to your Mac
  • Environment Variables - Set runtime environment
  • Volumes - Mount host directories into the container
  • Network - Choose which Docker network to attach
  • Resource Limits - Set CPU and memory constraints
  • Restart Policy - Configure auto-restart behavior
Zenithal new container form with image selection, port mappings, and volume configuration

Container Templates

Templates provide one-click container setup for popular services:

Free Tier (10 templates)

Nginx, Redis, PostgreSQL, MySQL, MongoDB, Alpine, Node.js, Python, Ubuntu, BusyBox

Pro Tier (65+ templates)

Additional databases, monitoring stacks, development tools, and more.

Zenithal container templates modal with quick-launch options for popular services

Terminal Access

Open an interactive terminal inside any running container:

  1. Select the container
  2. Click Terminal in the toolbar or press Cmd+T
  3. Choose your shell (bash, sh, or custom)

Tip: The terminal supports copy/paste, scrollback, and can be detached into a separate window.

Zenithal container logs view with real-time streaming and search filtering

File Browser

Explore and manage files inside running containers:

  • Navigate the filesystem visually
  • View and edit text files
  • Download files to your Mac
  • Upload files from your Mac
  • View file permissions and metadata
Zenithal container file browser showing filesystem navigation and file details

Resource Monitoring

Monitor container resource usage in real-time from the container detail view:

  • CPU - Usage percentage and core allocation
  • Memory - Current usage, limit, and swap
  • Network I/O - Bytes sent and received
  • Block I/O - Disk read/write operations

For system-wide monitoring, visit the Monitor section in the sidebar.

Zenithal CPU performance profiler showing real-time usage graphs and process breakdown

Bulk Operations

Select multiple containers using Cmd-click or Shift-click, then perform bulk actions:

  • Start/Stop/Restart all selected
  • Remove all selected
  • Export configurations