Back to Home
andrefaria24 icon

Homelab

Verified Safe

by andrefaria24

View Source

Overview

Orchestrates a comprehensive homelab environment, deploying and managing various services including Docker Swarm/K3s clusters, monitoring, and HashiCorp tools via Ansible.

Installation

Run Command
docker compose up -d

Environment Variables

  • VERSION
  • SUBDOMAIN
  • DOMAIN
  • HOSTNAME
  • VAULT_ADDR
  • VAULT_HOSTNAME
  • TFE_LICENSE
  • TFE_ENCRYPTION_PASSWORD
  • TFE_HOSTNAME
  • TFE_IACT_SUBNETS
  • POSTGRES_PASSWORD
  • PROMETHEUS_HOSTNAME
  • NODE_EXPORTER_HOSTNAME
  • GRAFANA_HOSTNAME
  • TARGET
  • GH_TOKEN
  • GH_OWNER
  • GH_REPOSITORY
  • PUID
  • PGID
  • TZ
  • USERNAME
  • PASSWORD
  • PLEX_SERVER
  • PLEX_SHARE
  • MOVIES_PATH
  • SHOWS_PATH
  • DOMAIN_NAME
  • GENERIC_TIMEZONE
  • TFE_ADDRESS
  • TFE_TOKEN
  • VAULT_NAMESPACE
  • COMPOSE_PROJECT_NAME

Security Notes

The codebase itself does not contain obvious malicious patterns or 'eval' statements. However, it heavily relies on environment variables for sensitive data like tokens (GitHub, K3s, Terraform Enterprise, Vault) and passwords (PostgreSQL, Plex CIFS mounts). Secure management of these variables (e.g., via Ansible Vault or `.env` files that are not committed to source control) is critical and not explicitly handled in the provided code snippets. Several Docker containers (e.g., Portainer, TFE) mount the host's Docker socket, granting them high privileges, which is standard for their functionality but represents a significant trust requirement.

Similar Servers

gitops-lab

4

A GitOps lab demonstrating multi-cluster application deployment and management (local-management, local-staging, local-production) for AI/ML inference (image background removal), multiplayer gaming, and .NET microservices using Argo CD, Helm, Istio, and related Kubernetes tooling.

Web & APIs
3
$High

homelab-mcp

3

Manage and monitor homelab infrastructure components (Docker, DNS, Network, AI, UPS, Ansible) through Claude Desktop.

AI & ML
8
$Low

WRLD_MCP_Collection

3

Manages and deploys a collection of MCP (Multi-Modal Compute Protocol) server configurations for WRLD Inc's development environments using Docker MCP Gateway.

Web & APIs
8
$High

homelab-mcp-server

1

Manages Docker containers and compose projects in a homelab environment via an MCP client like Claude.

6
$Medium

Stats

Interest Score30
Security Score7
Cost ClassMedium
Avg Tokens500
Stars1
Forks0
Last Update2025-12-13

Tags

HomelabAnsibleDockerKubernetesDevOpsMonitoringHashiCorp