{"id":26211525,"url":"https://github.com/achrovisual/hl-k3s","last_synced_at":"2026-01-31T00:39:16.464Z","repository":{"id":280121629,"uuid":"939354387","full_name":"achrovisual/hl-k3s","owner":"achrovisual","description":"This repository contains Helm charts for my home lab.","archived":false,"fork":false,"pushed_at":"2025-03-09T05:31:02.000Z","size":192,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-09T06:18:11.152Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Smarty","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/achrovisual.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":"2025-02-26T12:07:42.000Z","updated_at":"2025-03-09T05:31:05.000Z","dependencies_parsed_at":"2025-03-01T12:28:51.545Z","dependency_job_id":null,"html_url":"https://github.com/achrovisual/hl-k3s","commit_stats":null,"previous_names":["achrovisual/hl-k3s"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achrovisual%2Fhl-k3s","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achrovisual%2Fhl-k3s/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achrovisual%2Fhl-k3s/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/achrovisual%2Fhl-k3s/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/achrovisual","download_url":"https://codeload.github.com/achrovisual/hl-k3s/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243183267,"owners_count":20249768,"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":[],"created_at":"2025-03-12T08:28:14.350Z","updated_at":"2026-01-31T00:39:16.457Z","avatar_url":"https://github.com/achrovisual.png","language":"Smarty","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hl-k3s\n\n![CodeRabbit Pull Request Reviews](https://img.shields.io/coderabbit/prs/github/achrovisual/hl-k3s?utm_source=oss\u0026utm_medium=github\u0026utm_campaign=achrovisual%2Fhl-k3s\u0026labelColor=171717\u0026color=FF570A\u0026link=https%3A%2F%2Fcoderabbit.ai\u0026label=CodeRabbit+Reviews)\n\n[![K3s](https://img.shields.io/badge/K3s-FF0000?style=for-the-badge\u0026logo=kubernetes\u0026logoColor=white)](https://k3s.io/)\n[![Kubernetes](https://img.shields.io/badge/Kubernetes-326CE5?style=for-the-badge\u0026logo=kubernetes\u0026logoColor=white)](https://kubernetes.io/)\n[![Helm](https://img.shields.io/badge/Helm-0F1689?style=for-the-badge\u0026logo=helm\u0026logoColor=white)](https://helm.sh/)\n[![Argo CD](https://img.shields.io/badge/Argo_CD-EE4C2C?style=for-the-badge\u0026logo=argocd\u0026logoColor=white)](https://argoproj.github.io/cd/)\n[![YAML](https://img.shields.io/badge/YAML-CB171E?style=for-the-badge\u0026logo=yaml\u0026logoColor=white)](https://yaml.org/)\n[![GitHub Actions](https://img.shields.io/badge/GitHub_Actions-2088FF?style=for-the-badge\u0026logo=github-actions\u0026logoColor=white)](https://docs.github.com/en/actions)\n\n## 🚀 Overview\n\nThis repository is a curated collection of **Helm charts** for deploying and managing applications and services on a **K3s cluster**. While perfect for **home lab environments**, its core purpose is to serve as a playground for **exploring Kubernetes concepts** and for **personal development**. These charts streamline provisioning, offering a consistent and reproducible way to experiment with various applications, from common services to custom builds, and integrate them with GitOps tools like Argo CD.\n\n---\n\n## ✨ Features\n\n-   **Modular Helm Charts:** Enjoy organized and reusable charts for diverse applications and services.\n-   **Consistent Deployments:** Achieve standardized and repeatable deployments across your K3s cluster.\n-   **Simplified Application Management:** Use Helm to easily manage the lifecycle of your applications, including installation, upgrades, and rollbacks.\n-   **GitOps Ready:** Designed to work seamlessly with GitOps tools like **Argo CD** for automated deployments and synchronization, making your infrastructure declarative.\n-   **Home Lab \u0026 Development Focus:** Tailored for both typical home lab use cases and as a flexible environment for learning and personal projects.\n-   **Version Controlled Configurations:** All application configurations are stored as code within the charts, allowing for easy tracking, auditing, and experimentation.\n\n---\n\n## 🛠️ Technologies Used\n\n-   **Kubernetes Distribution:** [K3s](https://k3s.io/) (Lightweight Kubernetes, ideal for development)\n-   **Package Manager:** [Helm](https://helm.sh/) (for managing Kubernetes applications with ease)\n-   **GitOps:** [Argo CD](https://argoproj.github.io/cd/) (for continuous delivery, declarative deployments, and state synchronization)\n-   **Configuration Language:** [YAML](https://yaml.org/) (the standard for Kubernetes configurations)\n-   **Version Control:** [Git](https://git-scm.com/) / [GitHub](https://github.com/)\n-   **CI/CD:** [GitHub Actions](https://docs.github.com/en/actions) (for automated chart linting, testing, and deployment pipelines if implemented)\n\n---\n\n## ⚙️ Getting Started\n\nThis section outlines the steps to set up your K3s environment and deploy applications using the charts in this repository.\n\n### Prerequisites\n\nBefore you begin, ensure you have:\n\n-   A machine ready to host K3s (e.g., a Linux VM or Raspberry Pi).\n-   Basic Linux command-line knowledge.\n-   `sudo` access on the machine for installation steps.\n\n### Automated Setup\n\nFor a quick and automated setup of your K3s server, along with Kubeconfig setup, Helm installation, adding Helm repositories, cloning this Git repository, and installing Argo CD with initial applications, use the `setup.sh` script located in the `hl-scripts` repository.\n\n**Note:** This script is designed for a fresh K3s master node and assumes a specified user.\n\n1.  **Clone the `hl-scripts` repository:**\n    ```bash\n    git clone [https://github.com/achrovisual/hl-scripts.git](https://github.com/achrovisual/hl-scripts.git)\n    ```\n\n2.  **Navigate to the script directory:**\n    ```bash\n    cd hl-scripts/k3s/server/\n    ```\n\n3.  **Run the setup script:**\n    ```bash\n    ./setup.sh \u003cyour_username\u003e\n    ```\n    Replace `\u003cyour_username\u003e` with an existing user on your K3s master node (e.g., `alice`). This script will guide you through the automated setup process.\n\n---\n\n### Using the Helm Charts (After Setup)\n\nOnce your environment is set up by the automated script (which includes Helm and Argo CD installations), you can proceed to use the Helm charts for your deployments.\n\n---\n\n## 🚀 Deployment\n\nThese Helm charts are designed to facilitate the deployment of various applications and services into your K3s cluster. By maintaining these charts in a version-controlled repository, especially when coupled with GitOps tools like Argo CD, you can achieve consistent, automated, and auditable deployments for your home lab infrastructure and personal development sandbox. This approach embodies the GitOps philosophy, where your Git repository is the single source of truth for your cluster's desired state.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fachrovisual%2Fhl-k3s","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fachrovisual%2Fhl-k3s","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fachrovisual%2Fhl-k3s/lists"}