Skip to main content

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+ — install
  • talosctl 1.10+ — install
  • kubectl 1.28+ — install
  • kustomize 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.