{"id":13459328,"url":"https://github.com/abiosoft/colima","last_synced_at":"2025-05-12T18:47:25.868Z","repository":{"id":36970682,"uuid":"403020531","full_name":"abiosoft/colima","owner":"abiosoft","description":"Container runtimes on macOS (and Linux) with minimal setup","archived":false,"fork":false,"pushed_at":"2025-05-04T07:39:13.000Z","size":2876,"stargazers_count":22529,"open_issues_count":350,"forks_count":444,"subscribers_count":75,"default_branch":"main","last_synced_at":"2025-05-05T16:04:19.855Z","etag":null,"topics":["containerd","containerd-compose","containers","docker","docker-compose","incus","k3s","k8s","kubernetes","lima","macos","nerdctl"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abiosoft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"abiosoft","custom":["https://buymeacoffee.com/abiosoft"],"patreon":"colima"}},"created_at":"2021-09-04T09:52:22.000Z","updated_at":"2025-05-05T14:39:04.000Z","dependencies_parsed_at":"2023-09-27T11:44:58.888Z","dependency_job_id":"8dba75f8-ee51-4578-ad21-6605b872f5ba","html_url":"https://github.com/abiosoft/colima","commit_stats":{"total_commits":523,"total_committers":77,"mean_commits":6.792207792207792,"dds":0.2390057361376673,"last_synced_commit":"9b7f399aade5fa6ac87980924bd8882f9f57cd64"},"previous_names":[],"tags_count":57,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abiosoft%2Fcolima","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abiosoft%2Fcolima/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abiosoft%2Fcolima/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abiosoft%2Fcolima/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abiosoft","download_url":"https://codeload.github.com/abiosoft/colima/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253102033,"owners_count":21854491,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["containerd","containerd-compose","containers","docker","docker-compose","incus","k3s","k8s","kubernetes","lima","macos","nerdctl"],"created_at":"2024-07-31T09:01:16.075Z","updated_at":"2025-05-12T18:47:25.382Z","avatar_url":"https://github.com/abiosoft.png","language":"Go","readme":"![colima-logo](colima.png)\n\n## Colima - container runtimes on macOS (and Linux) with minimal setup.\n\n[![Go](https://github.com/abiosoft/colima/actions/workflows/go.yml/badge.svg)](https://github.com/abiosoft/colima/actions/workflows/go.yml)\n[![Integration](https://github.com/abiosoft/colima/actions/workflows/integration.yml/badge.svg)](https://github.com/abiosoft/colima/actions/workflows/integration.yml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/abiosoft/colima)](https://goreportcard.com/report/github.com/abiosoft/colima)\n\n![Demonstration](colima.gif)\n\n## Features\n\n  Support for Intel and Apple Silicon Macs, and Linux\n- Simple CLI interface with sensible defaults\n- Automatic Port Forwarding\n- Volume mounts\n- Multiple instances\n- Support for multiple container runtimes\n  - [Docker](https://docker.com) (with optional Kubernetes)\n  - [Containerd](https://containerd.io) (with optional Kubernetes)\n  - [Incus](https://linuxcontainers.org/incus) (containers and virtual machines)\n\n## Getting Started\n\n### Installation\n\nColima is available on Homebrew, MacPorts, and Nix. Check [here](docs/INSTALL.md) for other installation options.\n\n```\n# Homebrew\nbrew install colima\n\n# MacPorts\nsudo port install colima\n\n# Nix\nnix-env -iA nixpkgs.colima\n```\n\nOr stay on the bleeding edge (only Homebrew)\n\n```\nbrew install --HEAD colima\n```\n\n### Upgrading\n\nIf upgrading from v0.5.6 or lower, it is required to start afresh by deleting existing instance.\n\n```sh\ncolima delete # delete existing instance\ncolima start\n```\n\n## Usage\n\nStart Colima with defaults\n\n```\ncolima start\n```\n\nFor more usage options\n\n```\ncolima --help\ncolima start --help\n```\n\nOr use a config file\n\n```\ncolima start --edit\n```\n\n## Runtimes\n\nOn initial startup, Colima initiates with a user specified runtime that defaults to Docker.\n\n### Docker\n\nDocker client is required for Docker runtime. Installable with brew `brew install docker`.\n\nYou can use the `docker` client on macOS after `colima start` with no additional setup.\n\n### Containerd\n\n`colima start --runtime containerd` starts and setup Containerd. You can use `colima nerdctl` to interact with\nContainerd using [nerdctl](https://github.com/containerd/nerdctl).\n\nIt is recommended to run `colima nerdctl install` to install `nerdctl` alias script in $PATH.\n\n### Kubernetes\n\nkubectl is required for Kubernetes. Installable with `brew install kubectl`.\n\nTo enable Kubernetes, start Colima with `--kubernetes` flag.\n\n```\ncolima start --kubernetes\n```\n\n#### Interacting with Image Registry\n\nFor Docker runtime, images built or pulled with Docker are accessible to Kubernetes.\n\nFor Containerd runtime, images built or pulled in the `k8s.io` namespace are accessible to Kubernetes.\n\n### Incus\n\n\u003csmall\u003e**Requires v0.7.0**\u003c/small\u003e\n\n\nIncus client is required for Incus runtime. Installable with brew `brew install incus`.\n\n`colima start --runtime incus` starts and setup Incus.\n\nYou can use the `incus` client on macOS after `colima start` with no additional setup.\n\n**Note:** Running virtual machines on Incus is only supported on m3 or newer Apple Silicon devices.\n\n### None\n\n\u003csmall\u003e**Requires v0.7.0**\u003c/small\u003e\n\nColima can also be utilised solely as a headless virtual machine manager by specifying `none` runtime.\n\n\n### Customizing the VM\n\nThe default VM created by Colima has 2 CPUs, 2GiB memory and 100GiB storage.\n\nThe VM can be customized either by passing additional flags to `colima start`.\ne.g. `--cpu`, `--memory`, `--disk`, `--runtime`.\nOr by editing the config file with `colima start --edit`.\n\n**NOTE**: ~~disk size cannot be changed after the VM is created.~~ From v0.5.3, disk size can be increased.\n\n#### Customization Examples\n\n- create VM with 1CPU, 2GiB memory and 10GiB storage.\n\n  ```\n  colima start --cpu 1 --memory 2 --disk 10\n  ```\n\n- modify an existing VM to 4CPUs and 8GiB memory.\n\n  ```\n  colima stop\n  colima start --cpu 4 --memory 8\n  ```\n\n- create VM with Rosetta 2 emulation. Requires v0.5.3 and MacOS \u003e= 13 (Ventura) on Apple Silicon.\n\n  ```\n  colima start --vm-type=vz --vz-rosetta\n  ```\n\n## Project Goal\n\nTo provide container runtimes on macOS with minimal setup.\n\n## What is with the name?\n\nColima means Containers on [Lima](https://github.com/lima-vm/lima).\n\nSince Lima is aka Linux Machines. By transitivity, Colima can also mean Containers on Linux Machines.\n\n## And the Logo?\n\nThe logo was contributed by [Daniel Hodvogner](https://github.com/dhodvogner). Check [this issue](https://github.com/abiosoft/colima/issues/781) for more.\n\n## Troubleshooting and FAQs\n\nCheck [here](docs/FAQ.md) for Frequently Asked Questions.\n\n## Community\n- [GitHub Discussions](https://github.com/abiosoft/colima/discussions)\n- [GitHub Issues](https://github.com/abiosoft/colima/issues)\n- `#colima` channel in the CNCF Slack\n  - New account: \u003chttps://slack.cncf.io/\u003e\n  - Login: \u003chttps://cloud-native.slack.com/\u003e\n\n## Help Wanted\n\n- Documentation (wiki pages)\n\n## License\n\nMIT\n\n\n## Sponsoring the Project\n\nIf you (or your company) are benefiting from the project and would like to support the contributors, kindly sponsor.\n\n- [Github Sponsors](https://github.com/sponsors/abiosoft)\n- [Buy me a coffee](https://www.buymeacoffee.com/abiosoft)\n- [Patreon](https://patreon.com/colima)\n\n---\n\n[\u003cimg src=\"https://uploads-ssl.webflow.com/5ac3c046c82724970fc60918/5c019d917bba312af7553b49_MacStadium-developerlogo.png\" style=\"max-height: 150px\"/\u003e](https://macstadium.com)\n\n\n","funding_links":["https://github.com/sponsors/abiosoft","https://buymeacoffee.com/abiosoft","https://patreon.com/colima","https://www.buymeacoffee.com/abiosoft"],"categories":["Go Tools","Go","Software Packages","HarmonyOS","Tools for Self-Hosting","Docker-Tools","\u003ca name=\"Go\"\u003e\u003c/a\u003eGo","其他__大数据","macos","📦 Containers","Table of Contents"],"sub_categories":["DevOps Tools","Windows Manager","Containers","网络服务_其他"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabiosoft%2Fcolima","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabiosoft%2Fcolima","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabiosoft%2Fcolima/lists"}