{"id":31379360,"url":"https://github.com/imaginator/kube-bitcoin-stack","last_synced_at":"2025-09-28T07:48:32.395Z","repository":{"id":195489646,"uuid":"692450598","full_name":"imaginator/kube-bitcoin-stack","owner":"imaginator","description":"Bitcoin Production Engineering","archived":false,"fork":false,"pushed_at":"2024-09-03T17:31:49.000Z","size":407,"stargazers_count":5,"open_issues_count":3,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-09-26T15:49:05.496Z","etag":null,"topics":["bitcoin","kubernetes","lightning","lightning-network"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/imaginator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-16T14:14:53.000Z","updated_at":"2025-09-01T06:50:25.000Z","dependencies_parsed_at":"2024-08-28T08:36:26.506Z","dependency_job_id":null,"html_url":"https://github.com/imaginator/kube-bitcoin-stack","commit_stats":null,"previous_names":["imaginator/openlsp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/imaginator/kube-bitcoin-stack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imaginator%2Fkube-bitcoin-stack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imaginator%2Fkube-bitcoin-stack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imaginator%2Fkube-bitcoin-stack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imaginator%2Fkube-bitcoin-stack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imaginator","download_url":"https://codeload.github.com/imaginator/kube-bitcoin-stack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imaginator%2Fkube-bitcoin-stack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277340300,"owners_count":25801863,"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","status":"online","status_checked_at":"2025-09-28T02:00:08.834Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bitcoin","kubernetes","lightning","lightning-network"],"created_at":"2025-09-28T07:48:30.085Z","updated_at":"2025-09-28T07:48:32.384Z","avatar_url":"https://github.com/imaginator.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# kube-bitcoin-stack\n\nWelcome to **kube-bitcoin-stack**! 🎉\n\nThis project sets up a collection of Bitcoin-related services on Kubernetes, including:\n\n- **Bitcoind**: The reference Bitcoin node.\n- **BTCPayServer**: A self-hosted payment processor.\n- **Electrum**: A lightweight Bitcoin wallet.\n- **LND**: Lightning Network Daemon for Bitcoin's Lightning Network.\n- **CLN**: Core Lightning, another Lightning Network implementation.\n- Plus other useful services and tools!\n\n## Overview\n\nThis stack provides everything you need to run Bitcoin and Lightning Network services in a Kubernetes environment. It includes:\n\n- **Simplified YAML files**: Easy to import into your own projects or use as-is.\n- **Prometheus exporters**: For collecting metrics from all your services.\n- **Prometheus server**: Configured to aggregate metrics.\n- **Grafana dashboards**: To visualize operational and Bitcoin-related metrics.\n\n### Features\n\n- **Namespace Isolation**: Each service runs in its own Kubernetes namespace for better organization and management.\n- **Production-Ready**: Ideal for production engineering of Bitcoin services.\n- **Metrics \u0026 Monitoring**: Integrated Prometheus and Grafana for monitoring and visualization.\n\n## Getting Started\n\n1. **Clone the Repository**\n\n```bash\ngit clone https://github.com/imaginator/kube-bitcoin-stack.git\ncd kube-bitcoin-stack\n```\n\n2. **Apply Kubernetes Manifests**\n\nImport the provided YAML files into your Kubernetes cluster:\n\n```bash\nkubectl apply -f kube-bitcoin-stack/deployments/\u003cwhatever\u003e\n```\n\n3. **Access Services**\n\nEach service runs in its own namespace. Check out the Kubernetes services and deployments:\n\n```bash\nkubectl get services --all-namespaces\nkubectl get deployments --all-namespaces\n```\n\n4. **View Metrics**\n\nAll kube-bitcoin-stack services come with a Prometheus Exporter and Grafana Dashboard\n\n![Bitcoind Dashboard 4 Panels](docs/images/metrics-bitcoind-4-panels.png)\n\nAccess the Grafana dashboard for metrics and monitoring:\n\n```bash\nkubectl port-forward svc/grafana 3000:80 -n \u003cnamespace\u003e\n```\nThen navigate to http://localhost:3000 in your browser.\n\n## Use Cases\n\n- **Production Engineering**: Perfect for Site Reliability Engineers (SREs) or Production Engineers looking to manage Bitcoin and Lightning services.\n- **Alternative to Raspiblitz/Umbrel**: Run your own Bitcoin stack with all the monitoring and management tools you need.\n\n## Contributing\n\nIf you want to contribute to this project, feel free to fork the repository and submit a pull request. We welcome any improvements or suggestions!\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Support\n\nFor questions or support, open an issue on GitHub or contact us via the project's discussion forums.\n\nHappy Bitcoin stacking^Whacking! 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimaginator%2Fkube-bitcoin-stack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimaginator%2Fkube-bitcoin-stack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimaginator%2Fkube-bitcoin-stack/lists"}