colima

abiosoftMIT活跃维护

在 macOS 和 Linux 上一条命令就能搭好容器运行时环境,省去手动配置虚拟机和 Docker 的麻烦,还支持 Kubernetes、containerd 等多种后端。

Container runtimes on macOS (and Linux) with minimal setup

v0.10.3发布于 2026-06-04 17:14 UTC31,592star +31 / 7 天639fork同步于 2026-11-10 05:20 UTC

怎么上手

从 README 代码块原样提取,可能是其中一种安装方式
brew install colima
brew install --HEAD colima
docker run hello-world
docker ps
硬件要求按 README 关键词推断
支持 Apple Silicon有 Docker 镜像
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

这个项目的说明还在生成中,先参考下面「最近发版」和 README。

最近发版

5 个版本v0.10.3
  1. v0.10.3最新正式版2026-06-04 · 2026-06-04 17:14 UTC

    Highlights

    This is an hotfix release to address a regression for Kubernetes runtime.

    Commits

    Full Changelog: https://github.com/abiosoft/colima/compare/v0.10.2...v0.10.3

  2. v0.10.22026-06-03 · 2026-06-03 13:35 UTC
    查看更新说明

    Highlights

    This is an incremental stability release with bug fixes and features.

    Updates

    • New --downloader flag to retain curl for downloads. Supports curl or native (default).
    • Force stop with colima stop --force no longer attempts to stop the container runtime before stopping VM.
    • Support for user-provided containerd and buildkit config for the Containerd runtime.
    • Nested virtualization is now supported with krunkit vm type.
    • Soft delete (i.e. colima delete without --force) is now properly supported on Incus runtime, and container data would be auto-restored on recreation.
    • Cache directory can now be customized with the COLIMA_CACHE_HOME environment variable. The cache directory stores the downloaded assets used by Colima.
    • Network address is now supported for the krunkit vm type.
    • Runtime is now displayed in colima list for stopped instances.
    • Custom generated disk images can now be used by setting the --force-disk-image flag in addition to --disk-image flag. The image must be a debian based distro with systemd. Note that this is for power users and not officially supported.

    Runtime version bumps

    NOTE: container runtime versions can be updated manually by running the colima update command.

    • Docker version updated to v29.5.2
    • Nerdctl version updated to v2.3.1
    • Incus version updated to v7.1

    Commits

  3. v0.10.12026-02-22 · 2026-02-22 07:55 UTC
    查看更新说明

    Highlights

    This is an incremental release with support for Docker Model Runner and improvements to the AI functionality introduced in v0.10.0.

    Docker Model Runner

    Colima now supports Docker Model Runner as an AI model runner backend. Docker Model Runner is now the default due to its simpler requirements. However, Ramalama can still be used.

    # run a model (uses docker runner by default)
    colima model run gemma3
    
    # serve a model, chat interface available at localhost:8080
    colima model serve gemma3
    
    # explicitly specify the runner
    colima model run gemma3 --runner docker
    colima model run gemma3 --runner ramalama
    
    # set the runner at start time
    colima start --model-runner ramalama
    

    The runner can be configured via:

    • --runner flag on colima model commands
    • --model-runner flag at colima start
    • modelRunner in the configuration file

    Other Updates

    • The DOCKER_CONFIG environment variable is now respected.

    Commits

    New Contributors

    Full Changelog: https://github.com/abiosoft/colima/compare/v0.10.0...v0.10.1

  4. v0.10.02026-02-10 · 2026-02-10 20:11 UTC
    查看更新说明

    Highlights

    This release introduces AI support and other updates.

    AI is here

    Colima now has AI support.

    By leveraging Krunkit and Ramalama, Colima is able to provide the ideal platform to run confined, isolated and secure gpu-powered AI workloads on Apple Silicon devices.

    # run a model
    colima model run gemma3
    
    # serve a model, chat interface would be availabe at localhost:8080
    colima model serve gemma3
    
    # for more
    colima model --help
    

    Other Updates

    • Addition of krunkit virtual machine type with gpu support. colima start --vm-type krunkit.
    • Incus instances are now reachable directly from the host if network address is enabled. colima start --network-address.
    • Containerd runtime (with nerdctl command) now inherits CONTAINERD_* and NERDCTL_* environment variables on the host.
    • Port forwarding can now be disabled by passing --port-forwarder=none to colima start.
    • Volume mounts can now be disabled by passing --mount=none to colima start.
    • Download mechanism has been reworked in native Go, eliminating dependency on curl and shasum on the host.
    • New after-boot and ready provision modes for provision scripts.

    Runtime version bumps

    NOTE: container runtime versions can be updated manually by running the colima update command.

    • Docker version updated to v29.2.0
    • Nerdctl version updated to v2.2.1
    • Incus version updated to v6.21
    • K3s version defaults to v1.35.0+k3s1.

    Commits

  5. v0.9.12025-09-25 · 2025-09-25 11:07 UTC
    查看更新说明

    Highlights

    This is a hotfix release to address disk error issues for a subset of users.

    Check v0.9.0 release notes for the main release notes.

    Commits

    Full Changelog: https://github.com/abiosoft/colima/compare/v0.9.0...v0.9.1

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    colima-logo

    Colima - container runtimes on macOS (and Linux) with minimal setup.

    Go Integration Integration Go Report Card

    Demonstration

    Website & Documentation: colima.run | colima.run/docs

    Features

    Support for Intel and Apple Silicon macOS, and Linux

    • Simple CLI interface with sensible defaults
    • Automatic Port Forwarding
    • Volume mounts
    • Multiple instances
    • Support for multiple container runtimes
      • Docker (with optional Kubernetes)
      • Containerd (with optional Kubernetes)
      • Incus (containers and virtual machines)
    • GPU accelerated containers for AI workloads

    Getting Started

    Installation

    Colima is available on Homebrew, MacPorts, Nix and Mise. Check here for other installation options.

    # Homebrew
    brew install colima
    
    # MacPorts
    sudo port install colima
    
    # Nix
    nix-env -iA nixpkgs.colima
    
    # Mise
    mise use -g colima@latest
    
    

    Or stay on the bleeding edge (only Homebrew)

    brew install --HEAD colima
    

    Usage

    Start Colima with defaults

    colima start
    

    For more usage options

    colima --help
    colima start --help
    

    Or use a config file

    colima start --edit
    

    Runtimes

    On initial startup, Colima initiates with a user specified runtime that defaults to Docker.

    Docker

    Docker client is required for Docker runtime. Installable with brew install docker.

    colima start
    docker run hello-world
    docker ps
    

    You can use the docker client on macOS after colima start with no additional setup.

    Containerd

    colima start --runtime containerd starts and setup Containerd. You can use colima nerdctl to interact with Containerd using nerdctl.

    colima start --runtime containerd
    nerdctl run hello-world
    nerdctl ps
    

    It is recommended to run colima nerdctl install to install nerdctl alias script in $PATH.

    Kubernetes

    kubectl is required for Kubernetes. Installable with brew install kubectl.

    To enable Kubernetes, start Colima with --kubernetes flag.

    colima start --kubernetes
    kubectl run caddy --image=caddy
    kubectl get pods
    
    Interacting with Image Registry

    For Docker runtime, images built or pulled with Docker are accessible to Kubernetes.

    For Containerd runtime, images built or pulled in the k8s.io namespace are accessible to Kubernetes.

    Incus

    Requires v0.7.0

    Incus client is required for Incus runtime. Installable with brew brew install incus.

    colima start --runtime incus starts and setup Incus.

    colima start --runtime incus
    incus launch images:alpine/edge
    incus list
    

    You can use the incus client on macOS after colima start with no additional setup.

    Note: Running virtual machines on Incus is only supported on m3 or newer Apple Silicon devices.

    AI Models (GPU Accelerated)

    Requires v0.10.0, Apple Silicon and macOS 13+

    Colima supports GPU accelerated containers for AI workloads using the krunkit VM type.

    Note: To use krunkit with colima, ensure it is installed. Please follow their installation instructions

    Setup and use a model.

    colima start --runtime docker --vm-type krunkit
    colima model run gemma3
    

    Colima supports two model runner backends:

    The default registry is the Docker AI Registry. Models can be run by name without a prefix:

    colima model run gemma3
    colima model run llama3.2
    # HuggingFace (Docker Model Runner)
    colima model run hf.co/microsoft/Phi-3-mini-4k-instruct-gguf
    # Ollama (requires ramalama runner)
    colima model run ollama://gemma3 --runner ramalama
    

    See the AI Workloads documentation for more details.

    Customizing the VM

    The default VM created by Colima has 2 CPUs, 2GiB memory and 100GiB storage.

    The VM can be customized either by passing additional flags to colima start. e.g. --cpu, --memory, --disk, --runtime. Or by editing the config file with colima start --edit.

    NOTE: Disk size can be increased after the VM is created.

    Customization Examples
    • create VM with 1CPU, 2GiB memory and 10GiB storage.

      colima start --cpu 1 --memory 2 --disk 10
      
    • modify an existing VM to 4CPUs and 8GiB memory.

      colima stop
      colima start --cpu 4 --memory 8
      
    • create VM with Rosetta 2 emulation. Requires v0.5.3 and macOS >= 13 (Ventura) on Apple Silicon.

      colima start --vm-type=vz --vz-rosetta
      

    Project Goal

    To provide container runtimes on macOS with minimal setup.

    What is with the name?

    Colima means Containers on Lima.

    Since Lima is aka Linux Machines. By transitivity, Colima can also mean Containers on Linux Machines.

    And the Logo?

    The logo was contributed by Daniel Hodvogner. Check this issue for more.

    Troubleshooting and FAQs

    Check here for Frequently Asked Questions, or visit the online FAQ for a searchable version.

    How to Contribute?

    Check here for the instructions on contributing to the project.

    Community

    License

    MIT

    Sponsoring the Project

    If you (or your company) are benefiting from the project and would like to support the contributors, kindly sponsor.