Consul-k8s-control-plane

Consul-k8s-control-plane is HashiCorp's control plane for running Consul on Kubernetes.

  • Infrastructure
  • Tools & Utilities
Consul-k8s-control-plane is HashiCorp's control plane for running Consul on Kubernetes. It syncs services between Consul and your cluster, injects Consul sidecars for service mesh and traffic management, and provides service discovery with mTLS so applications can find and securely talk to each other.

Platform availability

Available on 0 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

70/100 Good

Maintained
100last commit 5 days ago
Popular
57708 GitHub stars
Easy to install
250 install platforms, install notes, Docker image
Light to run
No data
Security check
72no serious findings, 7 minor, CI, tests, OpenSSF Scorecard 7.4/10

Based on 4 of 5 factors.

GitHub stars
708
Open issues
366
Last commit
2026-11-16
Latest release
v2.1.0
License
MPL-2.0
Activity
declining

Checked 3 days ago - source: GitHub (hashicorp/consul-k8s)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Check install status after deployment After installing Consul's Kubernetes control plane, run consul-k8s status to see whether the main components came up correctly. If it reports problems, your cluster may not be ready for service discovery or other control-plane features. source
  • Use the correct namespace in CLI commands A Kubernetes namespace is a named area inside a cluster, so if you installed Consul into a custom one, add -namespace=YOUR_NAMESPACE to consul-k8s config read. This keeps you from checking the wrong installation or getting an empty result. source
  • Install basic packages before repo setup If you are adding HashiCorp's repository on Ubuntu or Debian, run sudo apt-get update and then install wget, gpg, and coreutils first. These tools help fetch and verify repository files, so missing them can make the install step fail. source
  • Install with Helm Deploy the Consul Kubernetes integration using the official Helm charts described in the Consul Kubernetes documentation, then confirm the install with the Consul CLI. source

Fetched 42 days ago - each note links to its source

Alternatives (5)

  • Arca Secrets - The local secrets manager for humans and AI agents.
  • Infisical - Infisical is an open-source platform for managing secrets, certificates, keys, and privileged access, helping development and operations te…
  • Norton Password Manager
  • VSecM - VMware Secrets Manager (VSecM) is a lightweight, self-hosted secrets manager that protects credentials and API keys in edge and resource-co…
  • openbao - OpenBao is an open-source, community-driven secrets manager and fork of HashiCorp Vault, managed by the Linux Foundation's OpenSSF, that se…

Checked 39 days ago - source: AlternativeTo

Common questions

How do I confirm the consul-k8s control plane is healthy after installation?

Run consul-k8s status to see whether the main components came up correctly. If it reports problems, the cluster may not be ready for service discovery or other control-plane features. Use the correct namespace in CLI commands if you installed Consul into a custom one.

What extra storage setup is needed for a self-hosted Kubernetes install?

You must pre-define Persistent Volume Claims and a default storage class for server agents. This is additional configuration beyond the standard cloud-hosted Kubernetes installation path.

Can I omit Consul client agents when using Consul Dataplanes?

Yes, client agents can be omitted with Consul Dataplanes. Server agents still run as a StatefulSet with a persistent volume.

Can Consul connect Kubernetes services to non-Kubernetes services?

Yes, service sync lets Kubernetes services discover and connect to external services registered in Consul. It also lets external services discover and connect to Kubernetes services.

Which areas should I check when troubleshooting consul-k8s?

Diagnose problems with the control plane, service mesh connectivity, API gateways, DNS resolution, and configuration synchronization between Kubernetes and Consul.

Answers sourced from deepwiki.com, developer.hashicorp.com, developer.hashicorp.com, developer.hashicorp.com, developer.hashicorp.com

Community

Collected 48 days ago - public community threads