ColimaUI

A native macOS app for managing Colima VMs and Docker containers.

Features

• Multi-VM Support: Create and manage multiple Colima VM profiles
• Container Management: View, start, stop, restart, and remove containers
• Real-time Stats: Live CPU and memory usage per container
• Log Viewer: Stream container logs in real-time
• Image Management: List and remove Docker images
• Volume Management: List, remove, and prune Docker volumes
• Cleanup Tools: Prune dangling images, build cache, and unused data
• Local Domains (Colima): Zero-config container/compose domains with automatic DNS, routing, and local TLS

Installation

1. Download the latest release from GitHub Releases
2. Unzip and drag ColimaUI.app to your Applications folder
3. On first launch, right-click the app and select Open (bypasses Gatekeeper for unsigned apps)

Or run this in Terminal to remove the quarantine flag:

xattr -cr /Applications/ColimaUI.app

Requirements

• macOS 14.0 (Sonoma) or later
• Colima installed via Homebrew
• Docker CLI

If you don't have Colima installed, the app will guide you through the installation process.

Local Domains

ColimaUI can configure local domains end-to-end from Settings:

• wildcard DNS via dnsmasq
• macOS resolver setup
• automatic reverse proxy startup
• automatic local TLS certs with mkcert
• index page at index.<suffix>

See detailed workflow documentation: docs/local-development-workflow.md

Generated domains:

• Compose service: service.project.<suffix>
• Container fallback: container-name.<suffix>

Configure in Settings -> Local Domains:

• Enable/disable local domain links
• Set domain suffix (default: .colima)
• Prefer HTTPS for link opening
• Automatic setup/check runs in-app (DNS, resolver, proxy, TLS, index health)
• Supports custom domain labels: dev.colimaui.domains
• Supports wildcard custom domains (for example *.api.mish)
• Supports HTTP port override label: dev.colimaui.http-port=8080

Example (custom domains + port override):

services:
  api:
    image: my-api
    labels:
      - dev.colimaui.domains=api.colima,docs.colima
      - dev.colimaui.http-port=3000

Building from Source

Requires XcodeGen to generate the Xcode project.

# Install XcodeGen if needed
brew install xcodegen

# Clone the repo
git clone https://github.com/ryanmish/ColimaUI.git
cd ColimaUI

# Generate Xcode project
xcodegen generate

# Open in Xcode
open ColimaUI.xcodeproj

# Build and run (Cmd+R)

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

Source Available - Free to use (including commercially), but not for resale. See LICENSE for details.