Homelab k3s Operations

Inspect pods, manage Helm releases, and debug k3s clusters.

Updated Sep 29, 2025
One-click install
npx skills add https://github.com/LucasSantana-Dev/homelab --skill homelab-k3s-operations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Homelab k3s Operations
Source: https://github.com/LucasSantana-Dev/homelab/tree/main/.claude/skills/homelab-k3s-ops
Command: npx skills add https://github.com/LucasSantana-Dev/homelab --skill homelab-k3s-operations

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides day-to-day operational commands and guidance for managing a homelab k3s Kubernetes cluster, simplifying tasks like pod inspection, Helm deployments, and debugging.

Core Features & Use Cases

  • Kubernetes Operations: Inspect pod status, logs, and resource usage.
  • Helm Management: Deploy, upgrade, and rollback Helm releases.
  • Debugging: Troubleshoot image pull failures, scheduling issues, and network policies.
  • Use Case: When a new application fails to deploy, use this Skill to check pod logs, describe the pod for events, and verify network policies to identify the root cause.

Quick Start

Use the Homelab k3s Operations skill to check the status of all pods across all namespaces.

Frequently Asked Questions about Homelab k3s Operations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage my k3s Kubernetes cluster for routine homelab operations?

Managing a k3s Kubernetes cluster involves inspecting pod status, deploying Helm releases, and debugging network policies. This Skill facilitates these day-to-day operations by providing targeted guidance for single-node k3s environments using kubectl and Helm.

How do I troubleshoot image pull failures and scheduling issues in a k3s cluster?

Troubleshooting k3s cluster issues requires checking pod logs and describing pod events. You can debug image pull failures and scheduling issues by inspecting resource usage and verifying network policies to identify the root cause of deployment failures.

Can I use Helm and kubectl to manage Traefik ingress on a single-node k3s setup?

Yes, you can use Helm and kubectl to manage Traefik ingress on a single-node k3s setup. This Skill supports k3s v1.34.5+k3s1 and provides operational commands for Helm release management and pod inspection within that specific environment.

What is the best way to deploy and rollback Helm releases in a homelab k3s environment?

Deploying and rolling back Helm releases in a k3s environment requires the Helm CLI tool. This Skill guides you through Helm release management, allowing you to efficiently deploy, upgrade, and rollback applications in your homelab cluster.

Do I need specific CLI tools installed to perform k3s cluster management operations?

Yes, you need kubectl and Helm CLI tools installed to execute k3s cluster management operations. These tools are required dependencies to inspect pods, manage local-path provisioner resources, and perform day-to-day debugging tasks.

Why does my newly deployed application fail to start on my k3s cluster?

A newly deployed application failing to start on a k3s cluster often indicates image pull failures or scheduling issues. Use this Skill to check pod logs, describe pod events, and verify network policies to identify the root cause.