Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nununo/ansible-role-proxmox-haos-install
Ansible role to install Home Assistant OS as a Proxmox VM
https://github.com/nununo/ansible-role-proxmox-haos-install
Last synced: 12 days ago
JSON representation
Ansible role to install Home Assistant OS as a Proxmox VM
- Host: GitHub
- URL: https://github.com/nununo/ansible-role-proxmox-haos-install
- Owner: nununo
- License: mit
- Created: 2022-01-30T01:58:18.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-11-25T10:42:04.000Z (12 months ago)
- Last Synced: 2024-10-11T02:44:09.622Z (28 days ago)
- Language: Nix
- Size: 43 KB
- Stars: 11
- Watchers: 3
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ansible role to install Home Assistant OS in Proxmox
Creates a VM in a Proxmox server and configures the latest release of [Home Assistant Operating System](https://github.com/home-assistant/operating-system) as its boot disk.
This role was heavily inspired by [this bash script](https://github.com/whiskerz007/proxmox_hassos_install). Thank you [whiskerz007](https://github.com/whiskerz007).
## Requirements
None.
## Role Variables
Available variables are listed below, along with default values (see `defaults/main.yml`):
```yaml
haos_proxmox_api_password: PLEASE_REDEFINE_ME
haos_proxmox_api_user: admin@pam
```
These are used for authentication. `haos_proxmox_api_password` is required and must always be redefined.
```yaml
haos_proxmox_node: node
```
The name of the node in which the VM will be installed.
```yaml
haos_proxmox_storage: local-zfs
```
The storage location where the VM disks (EFI and HAOS image) will be created. Currently only three storage types are supported: ZFS, LVM Thin and directory.
```yaml
haos_proxmox_cores: 1
haos_proxmox_description: 'Home Assistant'
haos_proxmox_mac_address: '' # If left empty a new one will be generated
haos_proxmox_memory: 4096
haos_proxmox_name: homeassistant
haos_proxmox_onboot: true
haos_proxmox_protection: true
haos_proxmox_sockets: 1
haos_proxmox_storage: local-lvm
haos_proxmox_storage_interface: sata0
```
Several VM attributes.
## Dependencies
None.
Note: While the role doesn't depend on any other roles, it uses `json_query()` which runs in your local machine and requires `jmespath` to be installed locally.
## Ansible Galaxy Installation
```bash
ansible-galaxy install nununo.proxmox_haos_install
```
## Example Playbook
```yaml
- hosts: myproxmox.mydomain.com
roles:
- role: nununo.proxmox_haos_install
```
Example of inventory entry:
```yaml
myhomeassistant.mydomain.com ansible_host=10.0.0.10 # (Proxmox's IP)
```
Example of host variables in `/host_vars/myhomeassistant.mydomain.com/vars.yml`:
```yaml
haos_proxmox_api_password: ENCRYPTED_PROXMOX_API_PASSWORD
haos_proxmox_api_user: root@pam
haos_proxmox_description: "MyHomeAssistant"
haos_proxmox_mac_address: 'AB:CD:EF:12:34:56'
haos_proxmox_name: myhomeassistsant
haos_proxmox_node: myproxmoxnode
haos_proxmox_storage: local-zfs
```
This role needs `sudo` capabilities.
## License
MIT / BSD
## Author Information
This role was created in 2022 by Nuno Godinho.