# Home Server Ansible Configuration

This directory contains Ansible playbooks for managing the Proxmox home server environment.

## Directory Structure

- `inventory/`: Contains the inventory file `hosts.ini` where you define your servers.
- `playbooks/`: Contains the actual Ansible playbooks.
- `ansible.cfg`: Local Ansible configuration.
- `requirements.yml`: List of Ansible collections required.

## Setup

1.  **Install Requirements**:
    ```bash
    ansible-galaxy install -r requirements.yml
    ```

2.  **Configure Inventory**:
    Edit `inventory/hosts.ini` and update the following:
    -   `ansible_host`: The IP address of your Proxmox node.
    -   `ansible_user`: The SSH user (usually root).
    -   `proxmox_api_*`: Variables if you plan to use API-based modules in the future.
    
    *Note: Ensure you have SSH key access to your Proxmox node for passwordless login, or uncomment `ansible_ssh_pass`.*

## Available Playbooks

### Create Ubuntu Cloud Template (`playbooks/create_ubuntu_template.yml`)

This playbook downloads a generic Ubuntu 22.04 Cloud Image and converts it into a Proxmox VM Template.

**Usage:**

```bash
# Run the playbook
ansible-playbook playbooks/create_ubuntu_template.yml
```

**Variables:**
You can override variables at runtime or by editing the playbook:

- `template_id`: Default `9000`
- `template_name`: Default `ubuntu-2204-cloud`
- `storage_pool`: Default `local-lvm`

Example overriding variables:
```bash
ansible-playbook playbooks/create_ubuntu_template.yml -e "template_id=9001 template_name=my-custom-template"
```