Consul-k8s-control-plane
Consul-k8s-control-plane is HashiCorp's control plane for running Consul on Kubernetes.
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
Variants
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
- Consul data plane is replacing consul client agent running in the ... (forum)
- Consul Issue while installing in Kubernetes using HELM (forum)
- Consul not selecting leader - Consul - HashiCorp Discuss (forum)
Collected 48 days ago - public community threads