server/proxmox/homeassistant

Home Assistant Installation

These files allow you to deploy a Home Assistant OS virtual machine on Proxmox using Terraform.

Terraform handles the creation of the VM based on the pre-built .qcow2 image of Home Assistant OS. All further configuration (such as the proxy settings) is done directly from the Home Assistant web interface.

Terraform Execution

To create the VM with Terraform, the configuration must be defined in the terraform.tfvars file. You can use terraform.tfvars.example as a base.

Then run the following commands:

1. Initialize Terraform:

terraform init

2. Review the plan:

terraform plan

3. Apply the plan:

terraform apply

The process will create a new VM on the configured Proxmox node using the uploaded .qcow2 image. Once created, Home Assistant OS will boot automatically and obtain an IP via DHCP.

Access the web interface at: http://homeassistant.local:8123

That should work given that Pi-hole is already runing on the network

Home Assistant Configuration

After the initial setup (creating your user and restoring backups if applicable), you must adjust the HTTP configuration to properly support a reverse proxy such as Traefik.

To edit Home Assistant’s configuration file configuration.yaml, first install the File Editor add-on:

1. Open the Home Assistant web interface.
2. Go to Settings -> Add-ons -> Add-on Store.
3. Search for File Editor and click Install.
4. Once installed, click Start and optionally enable Show in sidebar.

Then use the File Editor to open /config/configuration.yaml

Add the following section

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - "192.168.0.0/16"

Finally:

1. Go to Settings -> System -> Check configuration to validate the file.
2. Restart Home Assistant Core via Settings -> System -> Restart.

This ensures Home Assistant correctly interprets requests forwarded through your proxy, preserving real client IPs and maintaining secure access.

AC Integraion

To control the air conditioner that uses the NetHome Plus app, install HACS (Home Assistant Community Store) and the Midea AC LAN integration.

Step 1 - Install HACS

Follow the documentation at HACS

Step 2 — Install Midea AC LAN Integration

Follow the documentation at midea_ac_lan

Important: recent Midea / NetHome Plus API changes limit how tokens can be obtained. Keep a backup file containing your current tokens — it will be necessary if API access becomes restricted in the future. Tokens can be found via SSH at: /config/.storage/midea_ac_lan

Reinstallation

If a full reinstall is needed, simply destroy and recreate the Terraform resources:

terraform destroy

Then run:

terraform apply

to provision a clean instance again.