Detailed Setup Guide
This guide provides step-by-step instructions for setting up your homelab environment using OpenTofu and Talos Linux.
Prerequisites
- Proxmox access with your SSH key
opentofu
1.6+ — installtalosctl
1.10+ — installkubectl
1.28+ — installkustomize
5.0+ — install- This repository cloned locally
Initial Setup
First, navigate to the OpenTofu directory:
cd tofu
Create a terraform.tfvars
file with your configuration:
proxmox = {
name = "host3" # Your Proxmox host name
cluster_name = "host3" # Your Proxmox cluster name
endpoint = "https://pve:8006" # Your Proxmox API endpoint
insecure = false # Set to true if using self-signed certificates
username = "root@pam" # Your Proxmox username
api_token = "USER@pam!ID=TOKEN" # Your Proxmox API token
}
Initialize the OpenTofu configuration:
tofu init
Configuration
Create a terraform.tfvars
file with your specific configuration:
proxmox = {
name = "proxmox-host"
cluster_name = "homelab-cluster"
endpoint = "https://proxmox.example.com:8006"
insecure = false
username = "root"
api_token = "root@pam!token_id=your_token_secret"
}
Deployment Process
Preview the changes that will be applied:
tofu plan
Deploy the configuration to build your cluster:
tofu apply
After the cluster is deployed, follow the Manual Bootstrap Guide to initialize your Kubernetes environment.