{"id":13639872,"url":"https://github.com/solo-io/bumblebee","last_synced_at":"2025-05-15T18:10:40.338Z","repository":{"id":37398731,"uuid":"424577444","full_name":"solo-io/bumblebee","owner":"solo-io","description":"Get eBPF programs running from the cloud to the kernel in 1 line of bash","archived":false,"fork":false,"pushed_at":"2025-04-16T23:25:44.000Z","size":1805,"stargazers_count":1281,"open_issues_count":31,"forks_count":78,"subscribers_count":43,"default_branch":"main","last_synced_at":"2025-04-17T12:12:58.766Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/solo-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-11-04T11:54:39.000Z","updated_at":"2025-04-15T10:33:31.000Z","dependencies_parsed_at":"2023-02-19T13:15:37.098Z","dependency_job_id":"a8de2392-a03e-4b86-b210-24d7bee74bee","html_url":"https://github.com/solo-io/bumblebee","commit_stats":{"total_commits":204,"total_committers":16,"mean_commits":12.75,"dds":0.446078431372549,"last_synced_commit":"6d948e2781e42beeadb011893abb1eb457b9924d"},"previous_names":["solo-io/ebpf"],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solo-io%2Fbumblebee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solo-io%2Fbumblebee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solo-io%2Fbumblebee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solo-io%2Fbumblebee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/solo-io","download_url":"https://codeload.github.com/solo-io/bumblebee/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254394724,"owners_count":22063984,"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":[],"created_at":"2024-08-02T01:01:05.672Z","updated_at":"2025-05-15T18:10:40.303Z","avatar_url":"https://github.com/solo-io.png","language":"C","readme":"\u003ch1 align=\"center\"\u003e\n    \u003cimg src=\"logo.svg\" alt=\"Bumblebee\" width=\"60%\" height=\"60%\"\u003e\n\u003c/h1\u003e\n\nBumbleBee helps to build, run and distribute eBPF programs using OCI images. It allows you to focus on writing eBPF code, while taking care of the user space components - automatically exposing your data as metrics or logs.\n\nJoin the conversation [on our Slack](https://solo-io.slack.com/) in the [#bumblebee](https://solo-io.slack.com/app_redirect?channel=C02TEN3MV3J) channel!\nIf you need an invite to join, please [try here](https://slack.solo.io/).\n\n### Documentation\n- **Installation**\n  - [Install Bee](#Installation)\n- **Getting Started**\n\t- [What is eBPF?](https://ebpf.io/what-is-ebpf)\n\t-\t[Ramp up on BumbleBee concepts](docs/concepts.md)\n\t- [Write your first BumbleBee program](docs/getting_started.md)\n- **Developer Documentation**\n\t- [Contributing](docs/contributing.md)\n\n---\n## Getting Started\n\nThe first step to get started is to install `bee` using one of the [installation](#Installation) techniques listed below.\n\nOnce `bee` has been installed we can go ahead and initialize our first `eBPF` probe! To do this you just need to run one command! (no seriously that's it.)\n*Note*: This will only work on linux. If you don't have access to a linux machine, [Vagrant](https://learn.hashicorp.com/tutorials/vagrant/getting-started-install) will work as well!\n\n```bash\nsudo bee run ghcr.io/solo-io/bumblebee/tcpconnect:$(bee version)\n```\nTo see data populated simply run `curl httpbin.org` in another window.\n\n*Note*: If you installed `bee` via the install script you may see an issue with the `bee` command not being available when run with `sudo`.\nSee the [note on permissions](#a-note-on-permissions) for more info, but to quickly get started you can use the following command as an alternative:\n\n```bash\nsudo env \"PATH=$PATH\" bee run ghcr.io/solo-io/bumblebee/tcpconnect:$(bee version)\n```\n\nNow that you have run your first example program, you can go ahead and write your own with our [tutorial](docs/getting_started.md).\n\n## Installation\n\n### Using our install script\n\nDownload the latest version:\n\n```bash\ncurl -sL https://run.solo.io/bee/install | sh\n```\n\nOr download a given version (e.g. v0.0.8):\n\n```bash\ncurl -sL https://run.solo.io/bee/install | BUMBLEBEE_VERSION=v0.0.8 sh\n```\n\n### Using go\n```bash\ngit clone git@github.com:solo-io/bumblebee.git\ncd bumblebee\n# install to GOBIN (defaults to ~/go/bin/), can be used as `bee` if GOBIN is on your PATH\ngo install ./bee\n```\n\n#### Other options\n\nYou can also navigate to the releases page [here](https://github.com/solo-io/bumblebee/releases/) for more versions/information.\n\n### A note on permissions\n\nLoading eBPF programs to the kernel (`bee run` command) requires elevated privileges. \nYou can either run `bee` as root (with sudo), or add capabilities to the binary.\nAdding capabilities is the preferred method, as if you run `bee run` with `sudo`, it will not find local images when you run `bee build` without sudo.\n\nTo add capabilities, run the following command:\n\n```bash\nsudo setcap cap_sys_resource,cap_sys_admin+eip $(which bee)\n```\n\nOn newer kernels you may be able to pare down the capabilities added, for example a recent addition is the `CAP_BPF` capability.\n\n### Uninstall\n\nIf you installed `bee` via the install script, you can uninstall `bee` by removing the directory:\n\n```bash\nrm -rf $HOME/.bumblebee/\n```\n\nIf you used `bee` as root or via sudo, remove the following directory:\n\n```bash\nrm -rf /root/.bumblebee\n```\n\n### License\n\nApache 2\n\n### Thanks\n\nThis project would not be possible without the valuable open-source work of projects in the eBPF community. Specifically, we would like to thank the [eBPF go](https://github.com/cilium/ebpf/) library and [libbpf-tools](https://github.com/iovisor/bcc/tree/master/libbpf-tools/).\n","funding_links":[],"categories":["others","Networking \u0026 Connectivity","C"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolo-io%2Fbumblebee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolo-io%2Fbumblebee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolo-io%2Fbumblebee/lists"}