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.