We would love to hear from you! Here are some places you can find us.
Our mailing list is firstname.lastname@example.org. It’s for discussions around MetalLB usage, community support, and developer discussion (although for the latter we mostly use Github directly).
For a more interactive experience, we have the #metallb slack channel on k8s.slack.com. If you’re not already logged into the Kubernetes slack organization, you’ll need to request an invite before you can join.
If you prefer a more classic chat experience, we’re also on
on the Freenode IRC network. You can use Freenode’s web
if you don’t already have an IRC client.
Use the GitHub issue tracker to file bugs and features request. If you need support, please send your questions to the metallb-users mailing list rather than filing a GitHub issue.
We welcome contributions to MetalLB! Here’s some information to get you started.
This project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
Before you make significant code changes, please open an issue to discuss your plans. This will minimize the amount of review required for pull requests.
All submissions require review. We use GitHub pull requests for this purpose. Consult GitHub Help for more information on using pull requests.
MetalLB’s code is divided between a number of binaries, and some
supporting libraries. The libraries live in the
and each binary has its own top-level directory. Here’s what we
currently have, relative to the top-level directory:
controlleris the cluster-wide MetalLB controller, in charge of IP assignment.
speakeris the per-node daemon that advertises services with assigned IPs using various advertising strategies.
internal/k8scontains the bowels of the logic to talk to the Kubernetes apiserver to get and modify service information. It allows most of the rest of the MetalLB code to be ignorant of the Kubernetes client library, other than the objects (Service, ConfigMap…) that they manipulate.
internal/configparses and validates the MetalLB configmap.
internal/allocatoris the IP address manager. Given pools from the MetalLB configmap, it can allocate addresses on demand.
internal/bgpis a very stripped down implementation of BGP. It speaks just enough of the protocol to keep peering sessions up, and to push routes to the peer.
internal/layer2is an implementation of an ARP and NDP responder.
internal/loggingis a logging shim that redirects both Kubernetes’s
klogand Go’s standard library
logoutput to go-kit’s structured logger, which is what MetalLB itself uses for logging.
internal/versionjust burns version numbers and git commit information into compiled binaries, so that MetalLB can print its build information.
In addition to code, there’s deployment configuration and documentation:
manifestscontains a variety of Kubernetes manifests. The most important one is
manifests/metallb.yaml, which specifies how to deploy MetalLB onto a cluster.
helm-chartcontains the Helm chart for MetalLB. This chart is the authoritative source for MetalLB’s Kubernetes configuration,
manifests/metallb.yamlis autogenerated from it.
websitecontains the website for MetalLB. The
website/contentsubdirectory is where all the pages live, in Markdown format.
To develop MetalLB, you’ll need a couple of pieces of software:
Start by fetching the MetalLB repository, with
From there, you can use Invoke to build Docker images, push them to
registries, and so forth.
inv -l lists the available tasks.
For development, fork
the github repository, and add
your fork as a remote in
git remote add fork email@example.com:<your-github-user>/metallb.git.
The website at https://metallb.universe.tf is pinned to the latest released version, so that users who don’t care about ongoing development see documentation that is consistent with the released code.
However, there is a version of the website synced to the latest master
every branch has a published website at
name>--metallb.netlify.com. So if you want to view the documentation
for the 0.2 version, regardless of what the currently released version
is, you can
When editing the website, you can preview your changes locally by
installing Hugo and running
hugo server from