Skip to content
For use with automating my homelab
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
books
group_vars
.gitignore
ansible.cfg
hosts
readme.md

readme.md

Dilden's Ansible + Proxmox Homelab Automation

What is this?

This repo contains the Ansible playbooks and configuration used to manage and automate my Proxmox based homelab.

Installation

Clone this repo Ensure you also have Ansible installed

The main points

  • Configuration is set in ansible.cfg. This exists only to tell Ansible where to look for server definitions (inventory).
  • Servers (inventory) are defined in the hosts file and are placed in "groups" defined by []
  • The group_vars folder contains variables and credentials for use with the servers in those groups.
  • creds.yml will need to be created via ansible-vault create in the appropriate folder and will need to be configured like so: --- vault_api_password: 'PROXMOX_HOST_PASSWORD' From there, containers are configured within group_vars/virtualizer/vars.yml

After setting up everything, run the prep-host.yml playbook to ensure proxmoxer and other various dependencies are installed on the host.

Usage

Since I keep forgetting how to run these update commands, I figured I should document them here.

ansible-playbook books/update-host-all.yml --ask-vault-pass -u root will run the playbook that updates the host/virtualizer

ansible-playbook books/update-containers.yml --ask-vault-pass -u root will update all containers

You can’t perform that action at this time.