Colima Manager

Colima Manager (also known as Colima Visualizer) is a lightweight desktop GUI (Graphical User Interface) for managing your Colima and Docker environments. Built with Tauri, React, and TypeScript, it provides a modern alternative to using the Colima CLI.

Features

• View Colima status and configuration
• Run common Colima commands such as start, stop and restart
• View all running docker containers
  • Start, Stop and Restart containers
  • View logs for containers
• Modern UI with Tailwind CSS

Why Colima Manager?

Managing Colima through the CLI is powerful but not always intuitive. Colima Manager provides:

• A user-friendly desktop interface for Colima
• Quick access to Docker containers and logs
• Easier workflows for developers who prefer a GUI over the terminal

Project Status

⚠️ Work in Progress
Colima Manager is an early-stage project and is under active development. Some features may be experimental, and we’re eager to hear your ideas!

💡 Have a feature request? Open an issue or start a discussion.

Prerequisites

Before running Colima Visualizer, ensure you have the following installed:

• Docker
• Colima
• Node.js (v20+ recommended)
• Rust (required for Tauri backend)

Verify Installation

• Docker:
  Run docker --version in your terminal.
  You should see the Docker version output.

• Colima:
  Run colima status in your terminal.
  You should see Colima status output.
  If Colima is not running, start it with colima start.

Getting Started

1. Clone the repository:

   git clone https://github.com/yourusername/colima-visualizer.git
   cd colima-visualizer

2. Install dependencies:

   npm install

3. Run the application in development mode:

   npm run tauri dev

4. Build for production:

   npm run build
   npm run tauri build

Usage

• Launch the app, use it to start colima if not running.
• Follow your normal docker workflow
• View status, container lists, images, and more.

Colima Start

Docker compose Start and view logs:

Feature Ideas Welcome 🎉

We want Colima Manager to be shaped by the community!
If there’s a feature you’d love to see (e.g., metrics dashboard, advanced Docker Compose tools, Kubernetes integration), please open a feature request.

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

• Fork the repo and create your branch
• Submit a pull request with a clear description

Support

If you find this project helpful, consider supporting:

• Buy Me a Coffee

License

This project is licensed under the MIT License. See LICENSE for details.