{"id":13401394,"url":"https://github.com/lxc/go-lxc","last_synced_at":"2025-04-09T04:04:04.395Z","repository":{"id":14259304,"uuid":"16966971","full_name":"lxc/go-lxc","owner":"lxc","description":"Go bindings for liblxc","archived":false,"fork":false,"pushed_at":"2024-06-06T20:02:41.000Z","size":786,"stargazers_count":444,"open_issues_count":5,"forks_count":78,"subscribers_count":37,"default_branch":"v2","last_synced_at":"2025-03-23T13:01:54.633Z","etag":null,"topics":["containers","go","lxc"],"latest_commit_sha":null,"homepage":"https://linuxcontainers.org/lxc","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lxc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-02-18T22:58:36.000Z","updated_at":"2025-03-22T09:47:21.000Z","dependencies_parsed_at":"2024-01-13T17:11:54.791Z","dependency_job_id":"8664cb88-62c3-421f-89ae-080acf0b81e0","html_url":"https://github.com/lxc/go-lxc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lxc%2Fgo-lxc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lxc%2Fgo-lxc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lxc%2Fgo-lxc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lxc%2Fgo-lxc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lxc","download_url":"https://codeload.github.com/lxc/go-lxc/tar.gz/refs/heads/v2","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247974715,"owners_count":21026742,"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","go","lxc"],"created_at":"2024-07-30T19:01:02.225Z","updated_at":"2025-04-09T04:04:04.361Z","avatar_url":"https://github.com/lxc.png","language":"Go","funding_links":[],"categories":["Libraries"],"sub_categories":[],"readme":"[![go-lxc](https://linuxcontainers.org/static/img/containers.png)](https://linuxcontainers.org/)\n# Go Bindings for LXC (Linux Containers)\n\nLXC is the well-known and heavily tested low-level Linux container runtime. It\nis in active development since 2008 and has proven itself in critical\nproduction environments world-wide. Some of its core contributors are the same\npeople that helped to implement various well-known containerization features\ninside the Linux kernel.\n\n\nThis package implements [Go](https://golang.org) bindings for the [LXC](https://linuxcontainers.org/lxc/introduction/) C API (liblxc).\n\n## Status\nType            | Service               | Status\n---             | ---                   | ---\nCI (Linux)      | Github                | [![CI tests](https://github.com/lxc/go-lxc/actions/workflows/test.yml/badge.svg?branch=v2)](https://github.com/lxc/go-lxc/actions/workflows/test.yml)\nGo documentation    | Godoc                 | [![GoDoc](https://godoc.org/github.com/lxc/go-lxc?status.svg)](https://godoc.org/github.com/lxc/go-lxc)\nStatic analysis     | GoReport              | [![Go Report Card](https://goreportcard.com/badge/github.com/lxc/go-lxc)](https://goreportcard.com/report/github.com/lxc/go-lxc)\n\n## Requirements\n\nThis package requires [LXC \u003e= 1.0.0](https://github.com/lxc/lxc/releases) and its development package and their dependencies to be installed. Additionally, go-lxc requires Golang 1.10 or later to work. Following command should install required dependencies on Ubuntu 18.10:\n\n```bash\nsudo apt update\nsudo apt install git golang gcc make liblxc1 liblxc-dev lxc-utils pkg-config\n```\n\n## Installing\n\nTo install it, run:\n\n```bash\ngo get github.com/lxc/go-lxc\n```\n\n## Trying\n\nTo try examples, run:\n\n```bash\n# cd ~/go/src/github.com/lxc/go-lxc/examples/\n\n# make\n==\u003e Running go vet\n==\u003e Building ...\n...\n\n# create/create\n2018/12/27 22:39:27 Creating container...\n\n# start/start\n2018/12/27 22:39:39 Starting the container...\n2018/12/27 22:39:39 Waiting container to startup networking...\n\n# attach/attach\n2018/12/27 22:39:46 AttachShell\nroot@rubik:/# hostname\nrubik\nroot@rubik:/# exit\nexit\n2018/12/27 22:39:52 RunCommand\nuid=0(root) gid=0(root) groups=0(root)\n\n# stop/stop\n2018/12/27 22:39:54 Stopping the container...\n\n# destroy/destroy\n2018/12/27 22:39:57 Destroying container...\n```\n\n## Backwards Compatibility\n\nLXC has always focused on strong backwards compatibility. In fact, the API hasn't been broken from release `1.0.0` onwards. Main LXC is currently at version `2.*.*`.\n\n## Examples\n\nSee the [examples](https://github.com/lxc/go-lxc/tree/v2/examples) directory for some.\n\n## Bug reports\n\nBug reports can be filed at: \u003chttps://github.com/lxc/go-lxc/issues/new\u003e\n\n## Contributing\n\nFixes and new features are greatly appreciated. We'd love to see go-lxc improve. To contribute to go-lxc;\n\n* **Fork** the repository\n* **Modify** your fork\n* Ensure your fork **passes all tests**\n* **Send** a pull request\n\t* Bonus points if the pull request includes *what* you changed, *why* you changed it, and *tests* attached.\n\n## Getting help\n\nWhen you find you need help, the LXC projects provides you with several options.\n\n### Discuss Forum\n\nWe maintain an discuss forum at\n\n- https://discuss.linuxcontainers.org/\n\nwhere you can get support.\n\n### IRC\n\nYou can find support by joining `#lxcontainers` on `Freenode`.\n\n### Mailing Lists\n\nYou can check out one of the two LXC mailing list archives and register if interested:\n\n- http://lists.linuxcontainers.org/listinfo/lxc-devel\n- http://lists.linuxcontainers.org/listinfo/lxc-users\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flxc%2Fgo-lxc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flxc%2Fgo-lxc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flxc%2Fgo-lxc/lists"}