This repository has been archived on 2024-10-29. You can view files and clone it, but cannot push or open issues or pull requests.
homelab/README.md

74 lines
2.4 KiB
Markdown
Raw Permalink Normal View History

2024-09-23 08:34:34 +00:00
<!-- PROJECT LOGO -->
<br />
<div align="center">
2024-09-23 09:16:51 +00:00
<a href="https://git.fascinated.cc/Fascinated/homelab">
2024-09-23 08:34:34 +00:00
<img src="images/logo.png" alt="Logo" width="80" height="80">
</a>
<h3 align="center">Homelab</h3>
<p align="center">
Welcome to the configuration for my homelab.
<br />
2024-09-24 00:22:07 +00:00
<a href="https://git.fascinated.cc/Fascinated/home-ops/issues">Report Issue</a>
2024-09-23 08:34:34 +00:00
·
2024-09-24 00:29:06 +00:00
<a href="https://git.fascinated.cc/Fascinated/home-ops/issues">Request Feature/Service</a>
2024-09-23 08:36:26 +00:00
2024-09-23 08:34:34 +00:00
</p>
</div>
2024-09-23 08:40:30 +00:00
### Infrastructure
2024-09-26 14:44:06 +00:00
- [Kubernetes][k8s] - Isn't it obvious?
- [Helm][helm] - Easily deploy and manage Kubernetes applications
- [Traefik][traefik] - Web reverse proxy
- [Cert Manager][cert-manager] - Generates LetsEncrypt certificates
- [Metallb][metallb] - Load Balancer
- [NFS][nfs] - Remote Storage for PVs
- [FluxCD][fluxcd] - GitOps
- [Spegel][spegel] - Local Docker registry cache
- [Eraser][eraser] - Automated cleanup of old docker images
2024-09-23 08:40:30 +00:00
### Services
2024-09-26 13:50:23 +00:00
See [services](./kubernetes/apps/production/) for a list of services that I use in my homelab.
2024-09-23 08:34:34 +00:00
<!-- TODO -->
## Todo
2024-09-26 19:01:35 +00:00
- [ ] Setup Grafana and Traefik metrics
2024-09-23 08:43:18 +00:00
### Backlog
2024-09-23 09:30:05 +00:00
- [ ] Add some kind of guides for how to use this
2024-09-23 08:34:34 +00:00
See the [open issues](https://git.fascinated.cc/Fascinated/home-ops/issues) for a full list of proposed features (and known issues).
<!-- CONTRIBUTING -->
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
<!-- MARKDOWN LINKS & IMAGES -->
<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
2024-09-23 09:30:05 +00:00
2024-09-26 14:44:06 +00:00
[fluxcd]: https://fluxcd.io/
[k8s]: https://kubernetes.io/
[helm]: https://helm.sh/
[traefik]: https://traefik.io/
[cert-manager]: https://cert-manager.io/
[metallb]: https://metallb.org/
2024-09-27 10:19:27 +00:00
[nfs]: https://github.com/kubernetes-sigs/nfs-subdir-external-provisioner/
2024-09-26 14:44:06 +00:00
[spegel]: https://github.com/spegel-org/spegel/
2024-09-26 14:44:53 +00:00
[eraser]: https://github.com/eraser-dev/eraser/