{"id":13542539,"url":"https://github.com/liquidmetal-dev/flintlock","last_synced_at":"2026-03-14T13:01:42.079Z","repository":{"id":37452829,"uuid":"381020138","full_name":"liquidmetal-dev/flintlock","owner":"liquidmetal-dev","description":"Lock, Stock, and Two Smoking MicroVMs. Create and manage the lifecycle of MicroVMs backed by containerd.","archived":false,"fork":false,"pushed_at":"2025-03-25T12:32:49.000Z","size":5215,"stargazers_count":767,"open_issues_count":62,"forks_count":38,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-03-26T02:06:08.869Z","etag":null,"topics":["cni","firecracker","kvm","microvm","oci"],"latest_commit_sha":null,"homepage":"https://flintlock.liquidmetal.dev/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/liquidmetal-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-28T12:16:38.000Z","updated_at":"2025-03-25T19:31:10.000Z","dependencies_parsed_at":"2023-10-16T14:38:47.957Z","dependency_job_id":"6e9fc07d-b008-4794-85f6-7bd004a9ec5f","html_url":"https://github.com/liquidmetal-dev/flintlock","commit_stats":null,"previous_names":["weaveworks/reignite","weaveworks/flintlock","liquidmetal-dev/flintlock","weaveworks-liquidmetal/flintlock"],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liquidmetal-dev%2Fflintlock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liquidmetal-dev%2Fflintlock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liquidmetal-dev%2Fflintlock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liquidmetal-dev%2Fflintlock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/liquidmetal-dev","download_url":"https://codeload.github.com/liquidmetal-dev/flintlock/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246796835,"owners_count":20835454,"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":["cni","firecracker","kvm","microvm","oci"],"created_at":"2024-08-01T10:01:10.039Z","updated_at":"2026-03-14T13:01:42.071Z","avatar_url":"https://github.com/liquidmetal-dev.png","language":"Go","funding_links":[],"categories":["Go","hacktoberfest","others","Uncategorized","Projects","Self-hosted / Open Source"],"sub_categories":["Uncategorized","Security"],"readme":"# Flintlock - Create and manage the lifecycle of MicroVMs, backed by containerd.\n\n[![GitHub](https://img.shields.io/github/license/liquidmetal-dev/flintlock)](https://img.shields.io/github/license/liquidmetal-dev/flintlock)\n[![codecov](https://codecov.io/gh/liquidmetal-dev/flintlock/branch/main/graph/badge.svg?token=ZNPNRDI8Z0)](https://codecov.io/gh/liquidmetal-dev/flintlock)\n[![Go Report Card](https://goreportcard.com/badge/github.com/liquidmetal-dev/flintlock)](https://goreportcard.com/report/github.com/liquidmetal-dev/flintlock)\n\n## What is flintlock?\n\n\u003e :tada: **This project was originally developed by Weaveworks but is now owned \u0026 run by the community. If you are interested in helping out please reach out.**\n\nFlintlock is a service for creating and managing the lifecycle of microVMs on a host machine. We support the [Cloud Hypervisor](https://www.cloudhypervisor.org/) and [Firecracker](https://firecracker-microvm.github.io/) VMMs. \n\nThe original use case for flintlock was to create microVMs on a bare-metal host where the microVMs will be used as nodes in a virtualized Kubernetes cluster. It is an essential part of **Liquid Metal** and can be orchestrated by [Cluster API Provider Microvm](https://github.com/liquidmetal-dev/cluster-api-provider-microvm).\n\nHowever, its useful for many other use cases where lightweight virtualization is required (e.g. isolated workloads, pipelines).\n\n## Features\n\nUsing API requests (via gRPC or HTTP):\n\n- Create and delete microVMs\n- Manage the lifecycle of microVMs (i.e. start, stop, pause)\n- Configure microVM metadata via cloud-init, ignition etc\n- Use OCI images for microVM volumes, kernel and initrd\n- Expose microVM metrics for collection by Prometheus\n- (coming soon) Use CNI to configure the network for the microVMs\n\n## Documentation\n\nSee our [getting started with flintlock][quickstart] tutorial.\n\n## Contributing\n\nContributions are welcome. Please read the [CONTRIBUTING.md][contrib] and our [Code Of Conduct][coc].\n\nYou can reach out to the maintainers and other contributors using the [#liquidmetal](https://cloud-native.slack.com/archives/C07B5R5BLBZ) channel on the CNCF slack.\n\nOther interesting resources include:\n\n- [The issue tracker][issues]\n- [The list of milestones][milestones]\n- [Architectural Decision Records (ADR)][adr]\n- [Getting started with flintlock][quickstart]\n\n## Getting Help\n\nIf you have any questions about, feedback for or problems with flintlock:\n\n- [File an issue](CONTRIBUTING.md#opening-issues).\n\nYour feedback is always welcome!\n\n## Compatibility\n\nThe table below shows you which versions of Firecracker are compatible with Flintlock:\n\n| Flintlock         | Firecracker                      | Cloud Hypervisor  |\n| ----------------- | -------------------------------- | ----------------- |\n| v0.9.x            | Official v1.11+                  | v41.0             |\n| v0.8.x            | Official v1.10+                  | v41.0             |\n| v0.7.0            | Official v1.10+                  | v41.0             |\n| v0.6.0            | Official v1.0+ or v1.0.0-macvtap | v26.0             |\n| v0.5.0            | Official v1.0+ or v1.0.0-macvtap | v26.0             |\n| v0.4.0            | Official v1.0+ or v1.0.0-macvtap | **Not Supported** |\n| v0.3.0            | Official v1.0+ or v1.0.0-macvtap | **Not Supported** |\n| \u003c= v0.2.0         | \u003c= v0.25.2-macvtap               | **Not Supported** |\n| \u003c= v0.1.0-alpha.6 | \u003c= v0.25.2-macvtap               | **Not Supported** |\n| v0.1.0-alpha.7    | **Do not use**                   | **Not Supported** |\n| v0.1.0-alpha.8    | \u003c= v0.25.2-macvtap               | **Not Supported** |\n\n\u003e NOTE: we no longer support using the Weaveworks fork (with macvtap) of Firecracker. If you want macvtap then please use Cloud Hypervisor as the vm provider.\n\n## License\n\n[MPL-2.0 License][license]\n\n## Acknowledgements\n\nThe biggest acknowledgement goes to @Weaveworks who where pioneers in the early Kubernetes world and produced some fantastic open source that lives on despite the demise of the company. A big thank you to the company and everyone that worked there. It was the engineers at Weaveworks that originally created Liquid Metal. RIP Weaveworks.\n\n[quickstart]: https://www.liquidmetal.dev\n[contrib]: ./CONTRIBUTING.md\n[coc]: ./CODE_OF_CONDUCT.md\n[issues]: https://github.com/liquidmetal-dev/flintlock/issues\n[milestones]: https://github.com/liquidmetal-dev/flintlock/milestones\n[adr]: ./docs/adr\n[license]: ./LICENSE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliquidmetal-dev%2Fflintlock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliquidmetal-dev%2Fflintlock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliquidmetal-dev%2Fflintlock/lists"}