Homelab
Verified Safeby andrefaria24
Overview
This repository provides an Ansible-driven homelab setup for deploying and managing various services, including HashiCorp MCP (Multi-Cloud Platform) servers for Terraform and Vault.
Installation
docker compose -f docker/individual/mcp-servers/docker-compose.yml up -dEnvironment Variables
- K3S_TOKEN
- SMB_ADDR
- SMB_USER
- SMB_PASS
- VERSION
- SUBDOMAIN
- DOMAIN
- HOSTNAME
- VAULT_HOSTNAME
- TFE_LICENSE
- TFE_ENCRYPTION_PASSWORD
- POSTGRES_PASSWORD
- PROMETHEUS_HOSTNAME
- NODE_EXPORTER_HOSTNAME
- GRAFANA_HOSTNAME
- TARGET
- GH_TOKEN
- GH_OWNER
- GH_REPOSITORY
- DOMAIN_NAME
- GENERIC_TIMEZONE
- VAULT_ADDR
- VAULT_TOKEN
- VAULT_NAMESPACE
- TFE_ADDRESS
- TFE_TOKEN
Security Notes
The project follows good security practices by utilizing environment variables for secrets (e.g., `SMB_USER`, `GH_TOKEN`, `POSTGRES_PASSWORD`, `VAULT_TOKEN`) instead of hardcoding them directly in Docker Compose files. Credential files for SMB mounts are created with restrictive permissions (`0600`). However, some placeholders like `k3s_static_token: "<STATIC TOKEN>"` explicitly require user replacement and could pose a risk if left unconfigured. The overall security relies heavily on the user's secure management of `.env` files and proper configuration of services.
Similar Servers
homelab-mcp
Provides Model Context Protocol (MCP) servers for managing and monitoring homelab infrastructure through Claude Desktop.
gitops-lab
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.
WRLD_MCP_Collection
Manages and deploys a collection of MCP (Multi-Modal Compute Protocol) server configurations for WRLD Inc's development environments using Docker MCP Gateway.
homelab-mcp
Provides AI models with remote control capabilities for monitoring and managing homelab infrastructure, including Docker, OPNsense, TrueNAS, Proxmox, and Home Assistant.