docker-desktop

Docker Desktop

Docker Desktop provides a comprehensive GUI, integrated Kubernetes cluster, credential management, and development extensions for containerized software delivery.

When to Use

Local Containerized Development on macOS & Windows: Running Docker and Kubernetes with native OS filesystem optimizations.
VirtioFS & Rosetta 2 Virtualization (Apple Silicon): Fast cross-platform x86_64 emulation and high-speed disk sharing on macOS.
Single-Node Local Kubernetes: One-click local Kubernetes cluster for testing manifests and Helm charts.
Docker Extensions & Resource Allocation: Monitoring container CPU, memory, and disk usage visually.

Quick Start

# Check Docker Desktop daemon and engine version
docker version

# Test container runtime
docker run --rm hello-world

Inspect allocated CPU, memory, and disk resources

docker info


## Core Concepts

### VirtioFS & Resource Tuning Configuration

Optimizing disk performance in `settings.json`:

```json
{
  "cpus": 6,
  "memoryMiB": 12288,
  "swapMiB": 2048,
  "diskSizeMiB": 102400,
  "filesharingImplementation": "virtiofs",
  "useVirtualizationFramework": true,
  "useWindowsContainers": false,
  "kubernetes": {
    "enabled": true,
    "showSystemContainers": false
  }
}

Local Multi-Container Development Workflow

Orchestrating services with port publishing and health checks:

# Check Docker engine version and virtualization driver
docker version

# Inspect resource consumption across local containers
docker stats --no-stream

# Clean up build caches and dangling volumes to reclaim disk
docker system prune -a --volumes

Enabling Single-Node Kubernetes

Testing Kubernetes manifests locally:

# Switch kubectl context to Docker Desktop cluster
kubectl config use-context docker-desktop

# Verify local cluster nodes
kubectl get nodes

Common Patterns

Docker Compose Multi-Container Development Stack

Problem: Coordinating app, database, and cache containers locally with volume mounts.

Solution: Define unified docker-compose.yml:

version: "3.8"

services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgres://user:pass@db:5432/mydb
    volumes:
      - ./src:/app/src
    depends_on:
      - db

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: pass
      POSTGRES_DB: mydb
    ports:
      - "5432:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  pgdata:

Best Practices

Do:

Enable VirtioFS on macOS for up to 10x faster file-syncing in bind-mounted development directories.
Enable Rosetta 2 emulation on Apple Silicon to run x86_64 images with near-native performance.
Configure explicit memory and CPU limits in Docker Desktop settings to prevent starving host applications.
Run docker system prune --volumes periodically to reclaim gigabytes of orphaned build cache.

Don't:

Allocate 100% of host RAM to the Docker VM; leave at least 4GB-8GB for the host OS.
Use Docker Desktop in production server environments; deploy native Docker Engine or containerd on Linux.
Store persistent production data inside local Docker Desktop volumes.

Troubleshooting

Error	Cause	Solution
`Docker Desktop failed to start`	Corrupted settings JSON or port conflict in virtualization service.	Reset Docker to factory defaults in Troubleshoot menu.
`Slow file synchronization on macOS/Windows`	Legacy osxfs/gRPC FUSE file sharing slowing down volume mounts.	Enable VirtioFS in Docker Desktop Settings > General / Virtualization.
`No space left on device`	Virtual disk (`Docker.raw`) filled by dangling images and volumes.	Run `docker system prune -af --volumes` or resize virtual disk in Settings.

References

Docker Desktop Manual