{"id":13509839,"url":"https://github.com/canonical/lxd","last_synced_at":"2025-05-12T13:15:58.891Z","repository":{"id":37413072,"uuid":"26192117","full_name":"canonical/lxd","owner":"canonical","description":"Powerful system container and virtual machine manager","archived":false,"fork":false,"pushed_at":"2025-05-12T11:22:10.000Z","size":169207,"stargazers_count":4486,"open_issues_count":300,"forks_count":941,"subscribers_count":153,"default_branch":"main","last_synced_at":"2025-05-12T13:15:16.399Z","etag":null,"topics":["containers","criu","go","hacktoberfest","lxc","lxd"],"latest_commit_sha":null,"homepage":"https://canonical.com/lxd","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/canonical.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":".github/SUPPORT.md","governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2014-11-04T22:40:52.000Z","updated_at":"2025-05-12T09:21:48.000Z","dependencies_parsed_at":"2024-03-04T12:26:32.389Z","dependency_job_id":"c8a992f9-7433-43eb-935f-e439356746bb","html_url":"https://github.com/canonical/lxd","commit_stats":null,"previous_names":["canonical/lxd","lxc/lxd"],"tags_count":185,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/canonical%2Flxd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/canonical%2Flxd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/canonical%2Flxd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/canonical%2Flxd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/canonical","download_url":"https://codeload.github.com/canonical/lxd/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253745196,"owners_count":21957319,"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":["containers","criu","go","hacktoberfest","lxc","lxd"],"created_at":"2024-08-01T02:01:14.098Z","updated_at":"2025-05-12T13:15:58.872Z","avatar_url":"https://github.com/canonical.png","language":"Go","readme":"# LXD\n\nLXD is a modern, secure and powerful system container and virtual machine manager.\n\n\u003c!-- Include start LXD intro --\u003e\n\nIt provides a unified experience for running and managing full Linux systems inside containers or virtual machines. LXD supports images for a large number of Linux distributions (official Ubuntu images and images provided by the community) and is built around a very powerful, yet pretty simple, REST API. LXD scales from one instance on a single machine to a cluster in a full data center rack, making it suitable for running workloads both for development and in production.\n\nLXD allows you to easily set up a system that feels like a small private cloud. You can run any type of workload in an efficient way while keeping your resources optimized.\n\nYou should consider using LXD if you want to containerize different environments or run virtual machines, or in general run and manage your infrastructure in a cost-effective way.\n\n\u003c!-- Include end LXD intro --\u003e\n\n## Get started\n\nSee [Getting started](https://documentation.ubuntu.com/lxd/latest/getting_started/) in the LXD documentation for installation instructions and first steps.\n\n- Release announcements: [`https://discourse.ubuntu.com/c/lxd/news/`](https://discourse.ubuntu.com/c/lxd/news/143)\n- Release tarballs: [`https://github.com/canonical/lxd/releases/`](https://github.com/canonical/lxd/releases/)\n- Documentation: [`https://documentation.ubuntu.com/lxd/latest/`](https://documentation.ubuntu.com/lxd/latest/)\n\n## Status\n\nType                | Service               | Status\n---                 | ---                   | ---\nTests               | GitHub                | [![Build Status](https://github.com/canonical/lxd/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/canonical/lxd/actions?query=event%3Apush+branch%3Amain)\nGo documentation    | Godoc                 | [![GoDoc](https://godoc.org/github.com/canonical/lxd/client?status.svg)](https://godoc.org/github.com/canonical/lxd/client)\nStatic analysis     | GoReport              | [![Go Report Card](https://goreportcard.com/badge/github.com/canonical/lxd)](https://goreportcard.com/report/github.com/canonical/lxd)\nTranslations        | Weblate               | [![Translation status](https://hosted.weblate.org/widget/lxd/lxd/svg-badge.svg)](https://hosted.weblate.org/projects/lxd/lxd/)\n\n## Installing LXD from packages\n\nThe LXD daemon only works on Linux but the client tool (`lxc`) is available on most platforms.\n\nOS                  | Format                                            | Command\n---                 | ---                                               | ---\nLinux               | [Snap](https://snapcraft.io/lxd)                  | `snap install lxd`\nWindows             | [Chocolatey](https://chocolatey.org/packages/lxc) | `choco install lxc`\nmacOS               | [Homebrew](https://formulae.brew.sh/formula/lxc)  | `brew install lxc`\n\nThe LXD snap packaging repository is available [here](https://github.com/canonical/lxd-pkg-snap).\n\nFor more instructions on installing LXD for a wide variety of Linux distributions and operating systems, and to install LXD from source, see [How to install LXD](https://documentation.ubuntu.com/lxd/latest/installing/) in the documentation.\n\n## Client SDK packages\n\nThe LXD project provides SDK client packages for interacting with LXD servers from your own software.\n\nThese SDKs are licensed as Apache-2.0.\n\nLanguage  | URL\n---       | ---\nGo        | https://pkg.go.dev/github.com/canonical/lxd/client\nPython    | https://github.com/canonical/pylxd\n\nFor more information on using the LXD API, see [REST API](https://documentation.ubuntu.com/lxd/latest/restapi_landing/) in the documentation.\n\n## Tools for managing LXD\n\nIf you are looking for tools (beyond `lxc` CLI) to manage LXD at scale (from single server to wide clusters), the following projects can be useful:\n\nTool                        | Link\n---                         | ---\nAnsible - connection plugin | https://galaxy.ansible.com/ui/repo/published/community/general/content/connection/lxd/\nAnsible - inventory plugin  | https://galaxy.ansible.com/ui/repo/published/community/general/content/inventory/lxd/\nBolt - LXD transport        | https://www.puppet.com/docs/bolt/latest/bolt_transports_reference.html#lxd\nMicroCloud                  | https://canonical.com/microcloud\nPacker - LXD builder        | https://developer.hashicorp.com/packer/integrations/hashicorp/lxd/latest/components/builder/lxd\nTerraform provider          | https://registry.terraform.io/providers/terraform-lxd/lxd\n\n## Security\n\n\u003c!-- Include start security --\u003e\n\nConsider the following aspects to ensure that your LXD installation is secure:\n\n- Keep your operating system up-to-date and install all available security patches.\n- Use only supported LXD versions (LTS releases or the latest feature release).\n- Restrict access to the LXD daemon and the remote API.\n- Configure your network interfaces to be secure.\n- Do not use privileged containers unless required. If you use privileged containers, put appropriate security measures in place.\n  \u003c!-- Include end security --\u003e\n  See [Container security](https://documentation.ubuntu.com/lxd/latest/explanation/security/#container-security) for more information.\n\nSee [Security](https://documentation.ubuntu.com/lxd/latest/explanation/security/) for detailed information.\n\n**IMPORTANT:**\n\u003c!-- Include start security note --\u003e\nLocal access to LXD through the Unix socket always grants full access to LXD.\nThis includes the ability to attach file system paths or devices to any instance as well as tweak the security features on any instance.\n\nTherefore, you should only give such access to users who you'd trust with root access to your system.\n\u003c!-- Include end security note --\u003e\n\u003c!-- Include start support --\u003e\n\n## Support and community\n\nThe following channels are available for you to interact with the LXD community.\n\n### Bug reports\n\nYou can file bug reports and feature requests at: [`https://github.com/canonical/lxd/issues/new`](https://github.com/canonical/lxd/issues/new)\n\n### Forum\n\nA discussion forum is available at: [`https://discourse.ubuntu.com/c/lxd/`](https://discourse.ubuntu.com/c/lxd/126)\n\n### IRC\n\nIf you prefer live discussions, you can find us in [`#lxd`](https://web.libera.chat/#lxd) on `irc.libera.chat`. See [Getting started with IRC](https://discourse.ubuntu.com/t/getting-started-with-irc/37907) if needed.\n\n### Commercial support\n\nCommercial support for LXD is available through [Ubuntu Pro](https://ubuntu.com/support) (Ubuntu Pro (Infra-only) or full Ubuntu Pro).\nThe support covers all LTS versions for five years starting from the day of the release.\n\nSee the [full service description](https://ubuntu.com/legal/ubuntu-pro-description) for detailed information about what support Ubuntu Pro provides.\n\n## Documentation\n\nThe official documentation is available at: [`https://documentation.ubuntu.com/lxd/latest/`](https://documentation.ubuntu.com/lxd/latest/)\n\nYou can find additional resources on the [website](https://canonical.com/lxd), on [YouTube](https://www.youtube.com/channel/UCuP6xPt0WTeZu32CkQPpbvA) and in the [Tutorials section](https://discourse.ubuntu.com/c/lxd/tutorials/146) in the forum.\n\n\u003c!-- Include end support --\u003e\n\n## Contributing\n\nFixes and new features are greatly appreciated. Make sure to read our [contributing guidelines](CONTRIBUTING.md) first!\n","funding_links":[],"categories":["Go","go","hacktoberfest"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcanonical%2Flxd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcanonical%2Flxd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcanonical%2Flxd/lists"}