{"id":13481062,"url":"https://github.com/hashicorp/consul-k8s","last_synced_at":"2026-02-28T10:14:39.297Z","repository":{"id":37236625,"uuid":"139611779","full_name":"hashicorp/consul-k8s","owner":"hashicorp","description":"First-class support for Consul Service Mesh on Kubernetes","archived":false,"fork":false,"pushed_at":"2025-03-25T00:00:52.000Z","size":96300,"stargazers_count":683,"open_issues_count":243,"forks_count":325,"subscribers_count":146,"default_branch":"main","last_synced_at":"2025-03-27T16:53:29.833Z","etag":null,"topics":["consul","gateway","gateway-api","helm","helm-chart","ingress","kubernetes","service-mesh","servicemesh","vault"],"latest_commit_sha":null,"homepage":"https://www.consul.io/docs/k8s","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/hashicorp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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":"2018-07-03T16:43:37.000Z","updated_at":"2025-03-20T14:35:31.000Z","dependencies_parsed_at":"2023-10-16T09:14:43.278Z","dependency_job_id":"a6e6ba92-b02b-4f1d-807a-bf285a77236f","html_url":"https://github.com/hashicorp/consul-k8s","commit_stats":{"total_commits":3042,"total_committers":195,"mean_commits":15.6,"dds":0.8648915187376726,"last_synced_commit":"aacc8c78f5d3afb98a1948930ff9e275ed31ca95"},"previous_names":[],"tags_count":145,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fconsul-k8s","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fconsul-k8s/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fconsul-k8s/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fconsul-k8s/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hashicorp","download_url":"https://codeload.github.com/hashicorp/consul-k8s/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247266564,"owners_count":20910836,"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":["consul","gateway","gateway-api","helm","helm-chart","ingress","kubernetes","service-mesh","servicemesh","vault"],"created_at":"2024-07-31T17:00:48.249Z","updated_at":"2025-10-24T19:38:50.334Z","avatar_url":"https://github.com/hashicorp.png","language":"Go","funding_links":[],"categories":["Go","Operators vs Controllers"],"sub_categories":["Multi-Cluster"],"readme":"\u003ch1\u003e\n  \u003cimg src=\"./assets/logo.svg\" align=\"left\" height=\"46px\" alt=\"Consul logo\"/\u003e\n  \u003cspan\u003eConsul on Kubernetes\u003c/span\u003e\n\u003c/h1\u003e\n\n **We're looking for feedback on how folks are using Consul on Kubernetes. Please fill out our brief [survey](https://hashicorp.sjc1.qualtrics.com/jfe/form/SV_4MANbw1BUku7YhL)!** \n\n## Overview\n\nThe `consul-k8s-control-plane` binary includes first-class integrations between Consul and\nKubernetes. The project encapsulates multiple use cases such as syncing\nservices, injecting Consul sidecars, and more.\nThe Kubernetes integrations with Consul are\n[documented directly on the Consul website](https://www.consul.io/docs/platform/k8s/index.html).\n\nThis README will present a basic overview of use cases and installing the Helm charts, but for full documentation please reference the Consul website.\n\nThis project is versioned separately from Consul. Supported Consul versions\nfor each feature will be noted below. By versioning this project separately,\nwe can iterate on Kubernetes integrations more quickly and release new versions\nwithout forcing Consul users to do a full Consul upgrade.\n\n\u003e **Note**  \n\u003e We take Consul's security and our users' trust very seriously. If\nyou believe you have found a security issue in Consul K8s, _please responsibly disclose_\nby contacting us at [security@hashicorp.com](mailto:security@hashicorp.com).\n\n## Features\n    \n  * [**Consul Service Mesh**](https://developer.hashicorp.com/consul/docs/connect):\n    Run Consul Service Mesh on Kubernetes. This feature\n    injects Envoy sidecars and registers your Pods with Consul.\n\n  * [**Consul API Gateway**](https://developer.hashicorp.com/consul/docs/api-gateway):\n    Run Consul API Gateway on Kubernetes to allow north/south traffic into Consul Service Mesh.\n    \n  * [**Catalog Sync**](https://developer.hashicorp.com/consul/docs/k8s/service-sync):\n    Sync Consul services into first-class Kubernetes services and vice versa.\n    This enables Kubernetes to easily access external services and for\n    non-Kubernetes nodes to easily discover and access Kubernetes services.\n\n## Installation\n\n`consul-k8s` is distributed in multiple forms:\n\n  * The recommended installation method is the official\n    [Consul Helm chart](https://github.com/hashicorp/consul-k8s/tree/main/charts/consul). This will\n    automatically configure the Consul and Kubernetes integration to run within\n    an existing Kubernetes cluster.\n\n  * A [Docker image `hashicorp/consul-k8s-control-plane`](https://hub.docker.com/r/hashicorp/consul-k8s-control-plane) is available. This can be used to manually run `consul-k8s-control-plane` within a scheduled environment.\n\n  * Consul K8s CLI, distributed as `consul-k8s`, can be used to install and uninstall Consul Kubernetes. See the [Consul K8s CLI Reference](https://developer.hashicorp.com/consul/docs/k8s/k8s-cli) for more details on usage. \n\n### Prerequisites\n\nThe following pre-requisites must be met before installing Consul on Kubernetes. \n\n  * **Kubernetes 1.27.x - 1.30.x** - This represents the earliest versions of Kubernetes tested.\n    It is possible that this chart works with earlier versions, but it is\n    untested.\n  * Helm install\n    * **Helm 3.6+** for Helm based installs. \n  * Consul K8s CLI based install\n    * `kubectl` configured to authenticate to a Kubernetes cluster with a valid `kubeconfig` file.\n    * `brew`, `yum`, or `apt` package manager on your local machine \n\n### CLI\n\nThe Consul K8s CLI is the easiest way to get up and running with Consul on Kubernetes. See [Install Consul on K8s CLI](https://developer.hashicorp.com/consul/docs/k8s/installation/install-cli#install-the-cli) for more details on installation, and refer to \n[Consul on Kubernetes CLI Reference](https://developer.hashicorp.com/consul/docs/k8s/k8s-cli) for more details on subcommands and a list of all available flags\nfor each subcommand. \n\n\n 1. Install the HashiCorp tap, which is a repository of all Homebrew packages for HashiCorp:\n \n    ``` bash\n    brew tap hashicorp/tap\n    ```\n  \n2. Install the Consul K8s CLI with hashicorp/tap/consul formula.\n\n    ``` bash\n    brew install hashicorp/tap/consul-k8s\n    ```\n  \n3. Issue the install subcommand to install Consul on Kubernetes:\n   \n    ``` bash \n    consul-k8s install \n    ```\n\n### Helm\n\nThe Helm chart is ideal for those who prefer to use Helm for automation for either the installation or upgrade of Consul on Kubernetes. The chart supports multiple use cases of Consul on Kubernetes, depending on the values provided. Detailed installation instructions for Consul on Kubernetes are found [here](https://developer.hashicorp.com/consul/docs/k8s/installation/install). \n\n1. Add the HashiCorp Helm repository:\n   \n    ``` bash\n    helm repo add hashicorp https://helm.releases.hashicorp.com\n    ```\n    \n2. Ensure you have access to the Consul Helm chart and you see the latest chart version listed. If you have previously added the \n   HashiCorp Helm repository, run `helm repo update`. \n\n    ``` bash\n    helm search repo hashicorp/consul\n    ```\n\n3. Now you're ready to install Consul! To install Consul with the default configuration using Helm 3.2 run the following command below.\n   This will create a `consul` Kubernetes namespace if not already present, and install Consul on the dedicated namespace. \n \n   ``` bash\n   helm install consul hashicorp/consul --set global.name=consul --create-namespace -n consul\n\nPlease see the many options supported in the `values.yaml`\nfile. These are also fully documented directly on the\n[Consul website](https://developer.hashicorp.com/consul/docs/k8s/helm).\n\n## Tutorials\n\nYou can find examples and complete tutorials on how to deploy Consul on \nKubernetes using Helm on the [HashiCorp Learn website](https://learn.hashicorp.com/collections/consul/kubernetes).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhashicorp%2Fconsul-k8s","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhashicorp%2Fconsul-k8s","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhashicorp%2Fconsul-k8s/lists"}