13년차의 서버실

서버, 인프라, 홈랩 기술 블로그

[태그:] Home Assistant OS

  • [홈랩] Proxmox에 Home Assistant OS 구축: 안정적인 홈랩 베스트 프랙티스

    [홈랩] Proxmox에 Home Assistant OS 구축: 안정적인 홈랩 베스트 프랙티스

    목차

    [홈랩] Proxmox에 Home Assistant OS 구축: 안정적인 홈랩 베스트 프랙티스

    Proxmox Home Assistant OS 조합을 찾는 분들이 정말 많습니다. 저도 홈랩을 굴리면서 라즈베리 파이, Docker(도커), LXC(리눅스 컨테이너), 그리고 VM(가상머신)까지 이것저것 다 해봤거든요. 결론부터 말씀드리면, 장기적으로 덜 흔들리고 관리가 편한 쪽은 Proxmox 위에 HAOS(Home Assistant OS, 홈 어시스턴트 전용 운영체제)를 올리는 방식이었습니다. 처음엔 “굳이 전용 OS까지?” 싶었는데, Add-on(애드온, 확장 기능), 백업, 복구 흐름이 생각보다 깔끔해서 결국 이쪽으로 정착했네요.

    특히 스마트홈 서버는 한 번 꼬이면 집안 자동화가 줄줄이 멈춥니다. 조명 자동화가 안 되고, 센서 상태가 늦게 올라오고, 외부 접속도 어긋나고요. 그래서 이번 글에서는 제가 실제로 여러 번 구축하고 옮겨보면서 정리한 HAOS Proxmox 구성법과 운영 팁을 한 번에 정리해보겠습니다. 삽질도 좀 했습니다 ㅎㅎ 그래서 더 현실적인 가이드가 될 겁니다.

    Proxmox 가상화 환경 위에 Home Assistant OS가 올라가고, 라우터와 IoT 기기, NAS 백업 저장소가 연결된 전체 구조 예시입니다.

    왜 Proxmox와 Home Assistant OS 조합이 홈랩에 적합할까?

    쉽게 말해 Proxmox VE(프록스목스 가상화 환경)는 하드웨어 위에 여러 서버를 나눠 올리는 기반이고, HAOS는 Home Assistant를 가장 일관된 형태로 운영하기 위한 전용 이미지입니다. 이 둘을 합치면 장점이 꽤 분명합니다.

    • 분리 운영: NAS, 테스트용 리눅스 VM, 스마트홈 서버를 각각 독립적으로 운영하기 좋습니다.
    • 백업 편의성: Proxmox 백업과 Home Assistant 내부 백업을 이중으로 가져갈 수 있습니다.
    • 복구 속도: 장애가 나도 VM 단위로 되살리기 편합니다.
    • 확장성: USB 패스스루(USB passthrough, USB 장치 직접 연결), VLAN(가상 LAN), 별도 스토리지 연결이 수월합니다.

    제가 직접 써보니 Docker 설치형도 분명 가볍고 유연합니다. 근데 스마트홈 서버는 “가볍다”보다 안정적으로 오래 돌아가는가가 더 중요하더라고요. 특히 Zigbee(지그비) 동글이나 백업 복구까지 생각하면 HAOS 쪽이 훨씬 덜 피곤했습니다.

    설치 방식 비교: 어떤 선택이 덜 후회될까?

    방식 장점 주의점 추천 대상
    Home Assistant OS on VM 기능 구성이 완전하고 Add-on 사용이 편함 가상머신 자원 계획 필요 처음 구축하는 분, 안정성 우선
    Home Assistant Container 유연하고 직접 제어 범위가 넓음 Supervisor, Add-on 흐름이 다름 컨테이너 운영 경험이 많은 분
    LXC 기반 설치 자원 효율이 좋을 수 있음 지원 범위와 유지보수 판단이 중요 실험용, 구조를 잘 이해한 분

    여기서 중요한 포인트! 안정적인 홈랩 자동화를 목표라면 VM 기반 HAOS가 제일 덜 헷갈립니다. 결국 오래 버티는 구성이 이기거든요.

    구축 전 체크리스트: 시작 전에 이건 꼭 보세요

    처음엔 설치부터 눌러버리고 싶죠. 저도 그랬습니다. 근데 아래 항목을 먼저 정리해두면 나중에 재설치할 일이 확 줄어듭니다.

    1. 고정 IP 계획: Home Assistant가 받을 IP를 DHCP Reservation(고정 할당)으로 미리 정해두세요.
    2. 스토리지 위치: VM 디스크를 어느 스토리지에 둘지 정합니다. SSD 계열이면 체감이 좋습니다.
    3. 백업 저장소: Proxmox 백업과 Home Assistant 백업을 어디에 둘지 정하세요. 같은 디스크 하나만 믿으면 불안합니다.
    4. USB 장치 여부: Zigbee, Z-Wave 동글을 쓸 계획이면 패스스루 대상 장치를 미리 확인합니다.
    5. 브리지 네트워크: 보통 vmbr0 브리지에 붙이게 되는데, 기존 네트워크 구조와 충돌이 없는지 점검합니다.

    사실 스마트홈 서버는 설치보다 이전과 복구 전략이 더 중요합니다. 저도 처음엔 그냥 빨리 띄우는 데만 집중했었는데, 나중에 SSD 교체할 때 백업 설계가 안 되어 있어서 꽤 번거로웠습니다.

    실전 구축 1: HAOS 이미지를 Proxmox VM으로 올리기

    실전으로 가보겠습니다. 순서는 단순합니다. HAOS 이미지 준비 → Proxmox에 VM 생성 → 디스크 가져오기 → 부팅 흐름입니다.

    1. HAOS 이미지 준비

    Home Assistant OS용 qcow2 이미지를 준비합니다. 파일명은 시점에 따라 다를 수 있으니, 최신 릴리스에서 받았다고 가정하고 예시에서는 변수처럼 표기하겠습니다.

    cd /var/lib/vz/template/iso
ls
# 예시: haos_ova-xx.x.qcow2.xz 형태의 파일을 준비한 뒤 압축 해제
xz -d <HAOS_IMAGE_FILE>.xz
ls -lh

    파일명이 제각각이라 여기서 많이 헷갈리더라고요. 저도 처음엔 확장자만 보고 OVA(오브이엠에이)랑 QCOW2를 섞어서 봤었습니다. 핵심은 Proxmox에서 가져올 수 있는 디스크 이미지 파일을 준비하는 것입니다.

    2. VM 생성

    예시 VM ID는 300으로 잡아보겠습니다. 이름은 취향대로 정하시면 됩니다.

    qm create 300 \
  --name home-assistant \
  --memory 4096 \
  --cores 2 \
  --net0 virtio,bridge=vmbr0

    메모리와 코어는 환경에 맞게 조정하시면 됩니다. 제가 실제로 써보니 시작은 너무 타이트하게 잡지 않는 게 낫습니다. 나중에 애드온이 늘어나면 생각보다 금방 빡빡해지거든요.

    3. 디스크 이미지 가져오기

    스토리지 이름은 환경마다 다르니 local-lvm, local-zfs, data-store 같은 실제 이름으로 바꿔서 쓰시면 됩니다.

    qm importdisk 300 /var/lib/vz/template/iso/<HAOS_IMAGE_FILE>.qcow2 <TARGET_STORAGE>

    가져오기가 끝나면 Proxmox에서 해당 디스크를 VM에 연결해야 합니다.

    qm set 300 --scsihw virtio-scsi-pci
qm set 300 --scsi0 <TARGET_STORAGE>:vm-300-disk-0
qm set 300 --boot order=scsi0
qm set 300 --serial0 socket --vga serial0

    여기서 serial0 설정은 콘솔 확인할 때 꽤 편합니다. 부팅 로그를 볼 수 있어서 문제 생겼을 때 원인 파악이 빨라지더라고요.

    4. 첫 부팅

    qm start 300
qm status 300

    부팅 후에는 네트워크에서 Home Assistant가 IP를 받아야 합니다. 보통 웹 브라우저에서 http://<HA_IP>:8123으로 접속하거나, mDNS(멀티캐스트 DNS)가 되는 환경이면 http://homeassistant.local:8123 형태로 접근할 수 있습니다.

    HAOS Proxmox 가상머신 설정 화면 예시

    Proxmox UI에서 VM 하드웨어 항목, 디스크 연결, 부팅 순서를 확인하는 장면을 넣으면 초보자도 흐름을 따라가기 편합니다.

    실전 구축 2: 안정적으로 굴리기 위한 Proxmox 설정 팁

    설치만 끝났다고 끝이 아닙니다. Proxmox 가상화 환경에서 Home Assistant를 오래 안정적으로 돌리려면 몇 가지 운영 포인트를 잡아두는 게 좋습니다.

    가상 하드웨어는 단순하게

    • 네트워크 어댑터는 보통 virtio로 시작하면 무난합니다.
    • 디스크 버스는 SCSI 계열로 맞추면 관리가 편한 경우가 많습니다.
    • 무리한 CPU 타입 튜닝은 초기에 굳이 안 건드려도 됩니다.

    처음엔 저도 성능 욕심 나서 이것저것 최적화하려고 했는데, 스마트홈 서버는 극한 튜닝보다 예측 가능한 구성이 더 중요했습니다.

    백업은 두 겹으로

    이건 진짜 강조하고 싶습니다.

    1. Proxmox VM 백업을 정기적으로 수행합니다.
    2. Home Assistant 내부 백업도 별도로 남깁니다.

    한쪽만 믿으면 애매한 순간이 옵니다. VM 자체를 통째로 되돌릴 때와, Home Assistant 설정만 빠르게 복원할 때가 다르거든요.

    스냅샷은 업그레이드 직전에

    모든 스냅샷이 만능은 아니지만, 주요 변경 전에 하나 찍어두면 심리적으로도 훨씬 편합니다. 특히 통합(Integration, 연동 기능)이나 애드온 추가 전에는요.

    qm snapshot 300 pre-update
qm listsnapshot 300

    물론 스냅샷을 장기 보관 전략으로 쓰는 건 다릅니다. 운영 백업과 스냅샷은 역할이 다르다고 보시면 됩니다.

    ⚠️ 트러블슈팅: 제가 실제로 자주 부딪힌 문제들

    여기서는 진짜 많이 묻는 문제 위주로 정리해보겠습니다. 저도 처음엔 이게 뭔가 싶었는데, 패턴을 알고 나면 금방 풀립니다.

    1. 부팅은 되는데 웹 접속이 안 됩니다

    • 브리지(vmbr0) 연결이 맞는지 확인합니다.
    • DHCP에서 IP를 받았는지 라우터에서 확인합니다.
    • 초기 부팅 직후에는 준비 시간이 조금 필요할 수 있습니다.

    특히 첫 부팅 직후에는 바로 안 뜨는 경우가 있습니다. 괜히 중간에 강제 재부팅하지 말고 조금 기다려보세요. 저도 성격 급해서 몇 번 더 꼬이게 만든 적이 있습니다 ㅎㅎ

    2. USB 동글이 안 잡힙니다

    Zigbee 동글을 붙일 때 자주 나옵니다. 이 경우는 Proxmox에서 해당 USB 장치를 VM으로 패스스루해야 합니다. 장치가 바뀔 수 있으니 물리 포트 변경 후 다시 확인하는 습관이 필요합니다.

    • 호스트에서 USB 장치 식별이 되는지 먼저 확인
    • VM 하드웨어 항목에 USB 장치 추가
    • 재부팅 후 Home Assistant에서 장치 인식 여부 확인

    3. 업데이트 후 뭔가 이상합니다

    이럴 때는 무조건 “다시 만지기”보다 최근 변경 사항부터 되짚는 게 먼저입니다. 통합 추가, 애드온 설치, 네트워크 변경, 스토리지 변경 순으로 보시면 됩니다. 가능하면 업데이트 전 백업이나 스냅샷에서 비교해보세요.

    4. 리소스는 충분한데 체감이 느립니다

    이건 Home Assistant 자체 문제라기보다 호스트 스토리지, 다른 VM의 IO(입출력), 백업 시간대 겹침 때문에 생길 때가 많습니다. 홈랩 자동화 환경에서는 백업 작업이 한밤중에 몰리면서 응답이 늦어지는 경우도 있더라고요.

    Proxmox Home Assistant OS USB 패스스루와 브리지 네트워크 구성

    Zigbee 동글 USB 패스스루 흐름과 vmbr0 브리지 연결 구조를 시각적으로 보여주면 트러블슈팅 이해가 훨씬 쉬워집니다.

    검증과 결과: 구축이 잘 끝났는지 어떻게 확인할까?

    구축 후에는 “켜진다”만 확인하면 반쪽입니다. 저는 아래 순서로 점검합니다.

    1. 웹 접속 확인: 8123 포트로 접속이 안정적으로 되는지
    2. 재부팅 테스트: Proxmox 호스트 재부팅 후 VM이 정상 복구되는지
    3. 백업 복원 흐름 확인: 최소한 백업 파일 생성까지는 검증
    4. 주요 통합 확인: 센서, 스위치, 알림, 자동화가 정상 동작하는지

    실제로 써보니까, 여기서 제일 중요한 건 재부팅 후 정상 복구였습니다. 평소엔 멀쩡해도 정전이나 장비 교체 뒤에 문제가 터지는 경우가 있거든요. 그래서 저는 구축 직후 일부러 한 번 껐다 켜봅니다. 좀 귀찮아도 이게 나중에 진짜 편합니다.

    automation:
  - alias: "HA Start Notification"
    trigger:
      platform: homeassistant
      event: start
    action:
      - service: persistent_notification.create
        data:
          title: "Home Assistant"
          message: "Home Assistant가 정상적으로 시작되었습니다."
    mode: single

    이런 식으로 시작 알림을 하나 걸어두면 재부팅 후 상태 확인이 편합니다. 작은 팁인데 꽤 유용합니다.

    Proxmox Home Assistant OS 구축 후 대시보드 결과 화면

    센서 상태와 자동화 실행 이력이 정상적으로 보이는 Home Assistant 대시보드 예시입니다.

    운영하면서 느낀 베스트 프랙티스 정리

    • 처음부터 완벽하게 꾸미려 하지 않기: 우선 기본 자동화부터 안정화하세요.
    • 백업 경로 분리: 호스트와 게스트 내부 백업을 분리하면 복구 선택지가 늘어납니다.
    • USB 장치는 문서화: 어떤 동글이 어느 포트에 연결됐는지 메모해두면 좋습니다.
    • 업데이트는 한 번에 많이 하지 않기: 여러 요소를 동시에 바꾸면 문제 원인 추적이 어려워집니다.
    • 테스트용 자동화와 실사용 자동화 분리: 실험하다가 집안 전체 동작이 흔들리는 걸 줄일 수 있습니다.

    저도 예전엔 설정을 한 번에 몰아서 바꾸다가, 뭐가 문제인지 못 찾아서 결국 원복했던 적이 많았습니다. 지금은 작게 바꾸고 바로 검증하는 쪽으로 완전히 습관이 바뀌었네요.

    자주 묻는 질문 FAQ

    Q1. 스마트홈 서버는 꼭 Proxmox 위에서 돌려야 하나요?

    아닙니다. 다만 여러 서비스를 함께 운영하는 홈랩이라면 Proxmox 같은 하이퍼바이저(Hypervisor, 가상화 기반 플랫폼)가 관리상 편합니다.

    Q2. HAOS Proxmox 구성은 초보자에게 어렵지 않나요?

    처음엔 용어가 낯설 수 있습니다. 근데 설치 흐름 자체는 생각보다 단순합니다. 오히려 장기 운영은 더 편한 편입니다.

    Q3. Docker 대신 HAOS를 고른 이유는 뭔가요?

    제가 직접 운영해보니 Add-on과 백업, 복구 흐름이 한 덩어리로 맞물리는 점이 좋았습니다. 특히 홈랩 자동화처럼 운영 기간이 길어질수록 장점이 더 보였습니다.

    마무리: Proxmox Home Assistant OS는 결국 운영 편의성 싸움입니다

    Proxmox Home Assistant OS 조합은 화려한 기술이라기보다, 오래 운영할수록 진가가 드러나는 방식입니다. 처음엔 VM 만들고 이미지 넣는 과정이 조금 번거롭게 느껴질 수 있습니다. 근데 한 번 안정화해두면 장애 대응, 백업, 이전 작업이 훨씬 수월해집니다. 저는 결국 “관리 가능한 복잡도”가 제일 중요하다고 느꼈습니다.

    혹시 지금 라즈베리 파이에서 옮길지 고민 중이시라면, 이번에는 단순 설치보다 복구 가능한 구조를 목표로 잡아보세요. 다음 글에서는 Proxmox 백업 전략이나 리버스 프록시(Reverse Proxy, 역방향 프록시), 외부 접속 구성도 이어서 다뤄볼 예정입니다. 이전 글에서 다룬 홈랩 네트워크 분리나 VLAN 구성과도 같이 보면 더 이해가 잘 되실 겁니다.

    설치 전 체크리스트, 운영 팁, 백업 전략을 한눈에 정리한 요약 인포그래픽 자리입니다.

  • [Proxmox] Proxmox HAOS 마이그레이션: VMware ESXi에서 안전하게 이전하기

    [Proxmox] Proxmox HAOS 마이그레이션: VMware ESXi에서 안전하게 이전하기

    홈랩 서버실 | Proxmox HAOS 마이그레이션: VMware ESXi에서 안전하게 이전하기

    안녕하세요, 13년차의 서버실입니다. 홈랩을 운영하면서 여러 하이퍼바이저(Hypervisor)를 오가다 보면, 언젠가 한 번쯤은 겪게 되는 고민이 있어요. 바로 기존 가상머신(Virtual Machine, VM)을 새로운 플랫폼으로 옮기는 마이그레이션(Migration)입니다. 특히 스마트 홈의 핵심인 Home Assistant OS(HAOS) 같은 친구들은 안정성이 중요해서 마이그레이션할 때 더욱 신중해지죠. 저도 최근에 오랫동안 잘 써오던 VMware ESXi 환경에서 Proxmox VE로 HAOS를 안전하게 이전하면서 꽤 삽질을 했거든요. 오늘은 그 경험을 바탕으로 여러분께 자세히 알려드리려고 합니다.

    혹시 여러분도 ESXi의 라이선스 정책 변화나, Proxmox VE의 유연한 기능들, 혹은 단순히 새로운 환경에 대한 호기심 때문에 마이그레이션을 고민하고 계신가요? 그렇다면 이 글이 큰 도움이 될 겁니다. 제가 직접 겪었던 시행착오와 해결 과정을 솔직하게 공유하면서, 여러분의 Proxmox HAOS 마이그레이션 여정을 조금 더 부드럽게 만들어 드릴게요. 자, 그럼 시작해 볼까요?

    VMware ESXi에서 Proxmox VE로 Home Assistant OS 마이그레이션 전체 개요

    VMware ESXi에서 Proxmox VE로 Home Assistant OS 마이그레이션 전체 개요 다이어그램입니다.

    1. 왜 VMware ESXi에서 Proxmox VE로 옮겨야 할까요?

    사실 VMware ESXi는 오랫동안 안정적인 가상화 플랫폼의 대명사였어요. 특히 엔터프라이즈 환경에서는 거의 표준이라고 할 수 있었죠. 저도 덕분에 많은 프로젝트를 ESXi 위에서 진행했었고요. 하지만 홈랩(Home Lab) 환경에서는 몇 가지 고민이 생기더라고요.

    • 라이선스 정책 변화: ESXi 무료 버전의 기능 제한이 점점 심해지고 있습니다. 특히 vSphere API 접근 제한은 백업이나 관리 자동화에 큰 걸림돌이 되죠.
    • 오픈소스의 유연성: Proxmox VE(Virtual Environment)는 완벽한 오픈소스 가상화 플랫폼입니다. KVM(Kernel-based Virtual Machine)과 LXC(Linux Containers)를 모두 지원해서 VM과 컨테이너를 한 곳에서 관리할 수 있다는 점이 정말 매력적이더라고요.
    • 커뮤니티와 학습: Proxmox는 활발한 커뮤니티와 방대한 자료 덕분에 새로운 기술을 익히고 실험하기에 좋은 환경을 제공합니다. 저처럼 이것저것 만져보는 걸 좋아하는 사람에게는 최고의 놀이터죠.

    이런 이유들로 저는 Proxmox VE로의 전환을 결심했고, 그 첫 타자로 홈랩의 심장인 Home Assistant OS를 옮겨보기로 했습니다.

    2. 개념 설명: Proxmox VE와 Home Assistant OS 간략히

    마이그레이션에 앞서, 핵심 개념들을 간단히 짚고 넘어갈까요?

    • Proxmox VE (Virtual Environment): 쉽게 말해, 서버 한 대에서 여러 개의 가상 서버를 돌릴 수 있게 해주는 운영체제라고 생각하시면 됩니다. VMware ESXi와 비슷한 역할을 하지만, 오픈소스라는 점이 가장 큰 차이점이에요. 웹 기반 인터페이스를 제공해서 관리도 편리하고요.
    • Home Assistant OS (HAOS): 스마트 홈 기기들을 한곳에 모아 관리하고 자동화할 수 있게 해주는 오픈소스 플랫폼입니다. 전용 OS 형태로 제공되어 가상머신 위에 설치하는 경우가 많죠. 저도 Z-Wave, Zigbee 동글(dongle)을 연결해서 사용하고 있습니다.
    • 마이그레이션 (Migration): 기존에 잘 돌아가던 가상머신을 다른 가상화 환경으로 옮기는 과정입니다. 단순히 파일을 복사하는 것 이상으로, 새로운 환경에 맞게 설정들을 조정해줘야 하죠.

    3. 실전 구현: VMware ESXi에서 HAOS VM 내보내기

    자, 이제 본론입니다. 제가 직접 해보니 몇 가지 포인트만 잘 지키면 생각보다 어렵지 않더라고요.

    3.1. Home Assistant OS VM 백업 및 종료

    가장 먼저 할 일은 HAOS VM을 백업하는 것입니다. 혹시 모를 상황에 대비해서 꼭 스냅샷(Snapshot)을 찍어두거나, Home Assistant 자체의 백업 기능을 활용해서 전체 백업 파일을 받아두세요. 그리고 VM을 정상적으로 종료(Shut Down)해야 합니다. 전원 끄기(Power Off) 말고, 반드시 OS 내부에서 종료 명령을 내려주세요. 데이터 무결성(Data Integrity)을 위해 아주 중요하거든요.

    3.2. OVF/OVA 형식으로 내보내기

    VMware ESXi에서 가상머신을 다른 환경으로 옮길 때 가장 일반적인 방법은 OVF(Open Virtualization Format) 또는 OVA(Open Virtual Appliance) 형식으로 내보내는 것입니다. OVA는 OVF 파일과 관련 디스크 이미지를 하나의 파일로 묶어둔 아카이브(Archive) 형태라고 보시면 돼요. 저는 OVA로 내보냈습니다.

    1. vSphere Client 또는 ESXi 웹 UI에 접속합니다.
    2. 내보낼 Home Assistant OS VM을 선택하고 마우스 오른쪽 버튼을 클릭합니다.
    3. ‘템플릿(Template)’ > ‘OVF 템플릿 내보내기(Export OVF Template…)’를 선택합니다.
    4. 저장할 위치와 파일명을 지정하고 ‘확인’을 누르면 내보내기가 시작됩니다. 시간이 좀 걸릴 수 있어요.
    VMware ESXi에서 Home Assistant OS 가상 머신을 OVF/OVA 형식으로 내보내는 과정

    VMware ESXi 웹 UI에서 Home Assistant OS 가상 머신을 OVF/OVA 형식으로 내보내는 화면입니다.

    3.3. 디스크 이미지 변환 (VMDK → QCOW2)

    Proxmox VE는 일반적으로 QCOW2나 RAW 형식의 디스크 이미지를 사용합니다. ESXi에서 내보낸 OVA 파일 안에는 VMDK 형식의 디스크 이미지가 들어있죠. 이걸 Proxmox에서 사용할 수 있는 형식으로 변환해야 합니다. 저는 Proxmox 서버에서 직접 변환하는 방법을 선택했어요. 이게 가장 빠르고 편하더라고요.

    1. 내보낸 OVA 파일을 Proxmox VE 서버의 특정 디렉토리(예: /var/lib/vz/template/iso/)로 옮깁니다. scp 명령어를 사용하면 편리합니다.
    2. Proxmox VE 서버에 SSH로 접속합니다.
    3. OVA 파일 압축을 해제합니다. OVA는 사실 .tar 아카이브 파일이에요.
    cd /var/lib/vz/template/iso/
tar -xvf homeassistant.ova

    압축을 풀면 .ovf 파일과 .vmdk 파일이 보일 겁니다.

    1. qemu-img 도구를 사용하여 VMDK 파일을 QCOW2로 변환합니다.
    qemu-img convert -f vmdk homeassistant-disk1.vmdk -O qcow2 homeassistant-disk1.qcow2

    이 명령어가 성공적으로 실행되면, homeassistant-disk1.qcow2 파일이 생성됩니다. 이 파일이 Proxmox VE에서 사용할 디스크 이미지예요.

    4. 실전 구현: Proxmox VE로 HAOS VM 가져오기

    이제 변환된 디스크 이미지를 Proxmox VE에 VM으로 등록할 차례입니다.

    4.1. 새 가상머신 생성 (디스크 없이)

    Proxmox VE 웹 UI에서 새로운 VM을 생성합니다. 이때 ‘하드 디스크(Hard Disk)’ 단계에서는 디스크를 추가하지 않고 넘어가는 것이 중요해요. 나중에 변환한 디스크를 직접 연결할 거거든요.

    1. Proxmox VE 웹 UI에 접속합니다.
    2. 우측 상단 ‘VM 생성(Create VM)’ 버튼을 클릭합니다.
    3. ‘일반(General)’ 탭에서 이름과 VM ID를 지정합니다. (예: homeassistant-new, ID 100)
    4. ‘OS’ 탭에서 ‘미디어 사용 안 함(Do not use any media)’을 선택합니다.
    5. ‘시스템(System)’ 탭에서 기본값으로 두거나 필요한 경우 수정합니다. (저는 VMWare에서 사용하던 BIOS 대신 UEFI를 선택했어요.)
    6. ‘디스크(Disks)’ 탭에서 ‘디스크를 추가하지 않음(Do not add a disk)’을 선택하고 다음으로 넘어갑니다.
    7. ‘CPU’ 및 ‘메모리(Memory)’를 적절히 설정합니다. HAOS는 2코어, 4GB RAM 정도면 충분해요.
    8. ‘네트워크(Network)’ 탭에서 원하는 브리지(Bridge)를 선택합니다. (일반적으로 vmbr0)
    9. 마지막 ‘확인(Confirm)’ 단계에서 설정을 다시 확인하고 ‘완료(Finish)’를 클릭합니다.

    4.2. 변환된 디스크 이미지 임포트

    생성된 VM에 아까 변환했던 .qcow2 디스크 이미지를 연결합니다.

    1. Proxmox VE 서버에 SSH로 접속합니다.
    2. 다음 명령어를 사용하여 디스크 이미지를 생성한 VM (예: ID 100)으로 임포트합니다. local-lvm은 디스크 이미지를 저장할 스토리지 풀 이름입니다. 여러분의 환경에 맞게 변경해주세요.
    qm importdisk 100 /var/lib/vz/template/iso/homeassistant-disk1.qcow2 local-lvm

    이 명령어가 완료되면, Proxmox VE 웹 UI의 VM 하드웨어 설정에 ‘사용하지 않는 디스크(Unused Disk)’로 추가된 것을 볼 수 있어요.

    4.3. 임포트된 디스크 연결 및 부팅 순서 설정

    1. Proxmox VE 웹 UI에서 생성한 VM (ID 100)을 선택하고 ‘하드웨어(Hardware)’ 탭으로 이동합니다.
    2. ‘사용하지 않는 디스크(Unused Disk)’를 더블클릭하거나 선택 후 ‘편집(Edit)’ 버튼을 눌러 디스크를 VM에 연결합니다. ‘버스/장치(Bus/Device)’는 ‘SATA’나 ‘VirtIO Block’ 중 선택하는데, 저는 일반적으로 성능이 좋은 VirtIO Block을 선호해요. ‘캐시(Cache)’ 설정도 필요에 따라 조정해주세요.
    3. ‘옵션(Options)’ 탭으로 이동하여 ‘부팅 순서(Boot Order)’를 편집합니다. 방금 연결한 디스크를 첫 번째 부팅 장치로 설정하고 ‘확인(OK)’을 클릭합니다.
    Proxmox VE에서 새로운 가상 머신 생성 후 Home Assistant OS 디스크 이미지를 임포트하는 과정

    Proxmox VE 웹 UI에서 새로운 VM을 생성하고, SSH 터미널에서 qm importdisk 명령어를 통해 Home Assistant OS 디스크 이미지를 임포트하는 과정입니다.

    5. 주의사항 및 트러블슈팅 ⚠️ (삽질 경험 공유)

    제가 이 과정에서 겪었던 몇 가지 ‘삽질’과 그 해결 방법을 공유합니다. 여러분은 저 같은 실수를 하지 않으시길 바랍니다! ㅎㅎ

    • 네트워크 인터페이스 문제: 마이그레이션 후 HAOS가 네트워크를 잡지 못하는 경우가 있어요. ESXi와 Proxmox는 가상 네트워크 카드 드라이버가 다를 수 있거든요. HAOS는 보통 eth0을 사용하지만, Proxmox에서 VirtIO 네트워크 카드를 사용하면 이름이 바뀌거나 설정이 꼬일 수 있습니다.

      • 해결책: Proxmox VM 설정에서 네트워크 카드를 VirtIO 대신 E1000으로 변경해보세요. 또는 HAOS 콘솔에 접속해서 네트워크 설정을 수동으로 확인하고 network update 명령어를 통해 DHCP를 다시 시도해볼 수 있습니다.

    • VMware Tools 잔재: ESXi에서 설치했던 VMware Tools는 Proxmox에서는 필요 없어요. 이게 남아있으면 불필요한 리소스를 잡아먹거나 충돌을 일으킬 수도 있습니다. 사실 HAOS는 자체적으로 VM Tools 같은 걸 설치하지 않아서 크게 문제가 되지는 않지만, 다른 Linux VM을 마이그레이션할 때는 꼭 확인해주세요.

      • 해결책: 마이그레이션 전 ESXi에서 VM Tools를 제거하거나, Proxmox로 옮긴 후 해당 VM에 접속해서 제거하는 것이 좋습니다.

    • USB 패스스루(USB Passthrough): Zigbee나 Z-Wave 동글을 사용하신다면, Proxmox에서 USB 패스스루 설정을 새로 해줘야 합니다. ESXi에서 사용하던 설정이 그대로 넘어오지 않거든요.

      • 해결책: Proxmox 웹 UI에서 VM 하드웨어 설정에 들어가 ‘추가(Add)’ > ‘USB 장치(USB Device)’를 선택하고, ‘벤더/제품 ID 사용(Use vendor/product ID)’ 또는 ‘USB 포트 사용(Use USB Port)’을 통해 해당 동글을 연결해줍니다.

    • 디스크 용량 문제: HAOS VMDK 파일이 크면 변환 및 임포트 과정에서 시간이 오래 걸리고, 스토리지 용량을 충분히 확보해야 합니다. 저도 한 번은 Proxmox 서버의 /tmp 디렉토리 용량이 부족해서 변환이 실패한 적이 있었어요. 😅

      • 해결책: 변환 파일을 저장할 디렉토리에 충분한 여유 공간이 있는지 미리 확인하세요.

    6. 검증 및 결과 🎉 (드디어 새로운 둥지에서 HAOS 가 움직인다!)

    모든 설정이 끝나고 VM을 부팅하면, 이제 HAOS가 Proxmox VE 위에서 새로운 시작을 알릴 겁니다. 저는 부팅 후 다음 사항들을 꼼꼼히 확인했어요.

    1. HAOS 웹 인터페이스 접속: 가장 먼저 HAOS의 웹 UI에 접속해서 대시보드가 정상적으로 로드되는지 확인합니다.
    2. 네트워크 연결 상태: ‘설정(Settings)’ > ‘시스템(System)’ > ‘네트워크(Network)’에서 IP 주소와 게이트웨이(Gateway) 설정이 올바른지 확인합니다.
    3. 통합(Integrations) 작동 여부: 스마트 기기 연동(예: Philips Hue, SmartThings, Zigbee/Z-Wave 동글)이 제대로 작동하는지 하나씩 테스트해봅니다.
    4. 애드온(Add-ons) 상태: 설치했던 애드온들이 모두 정상적으로 실행되는지 확인해요.
    5. 리소스 사용량: Proxmox VE 웹 UI에서 VM의 CPU, 메모리, 디스크 I/O 사용량을 모니터링하여 ESXi 때와 비교해봅니다. 보통 Proxmox가 더 효율적인 경우가 많더라고요.

    이 모든 과정이 끝나고 HAOS 대시보드가 완벽하게 작동하는 것을 보니, 그동안의 삽질이 싹 잊히는 기분이었어요. 드디어 성공했구나! 하는 성취감이 밀려오더라고요. 🥳

    Proxmox VE에서 성공적으로 마이그레이션되어 작동 중인 Home Assistant OS 대시보드

    Proxmox VE 위에서 성공적으로 마이그레이션되어 작동 중인 Home Assistant OS 대시보드 화면입니다.

    7. 마무리: 배운 점과 다음 단계

    VMware ESXi에서 Proxmox VE로 Home Assistant OS를 마이그레이션하는 과정은 단순히 파일을 옮기는 것을 넘어, 새로운 가상화 환경에 대한 이해와 트러블슈팅 능력을 길러주는 좋은 경험이었습니다. 제가 얻은 몇 가지 교훈은 이렇습니다.

    • 사전 백업의 중요성: 아무리 강조해도 지나치지 않아요.
    • 문서화의 습관화: 제가 어떤 설정을 했는지, 어떤 삽질을 했는지 기록해두면 다음번에 훨씬 수월합니다.
    • 오픈소스 커뮤니티의 힘: 막히는 부분이 있을 때 Proxmox 포럼이나 Home Assistant 커뮤니티에서 많은 도움을 받을 수 있었어요.

    이제 여러분의 Home Assistant OS는 Proxmox VE라는 새로운 환경에서 더욱 안정적이고 유연하게 동작할 겁니다. 다음 단계로는 Proxmox VE의 강력한 백업 기능(Proxmox Backup Server와 연동)을 활용하여 HAOS 백업 전략을 수립하거나, VM에 GPU 패스스루를 설정하여 미디어 서버 등 다른 서비스를 구축하는 것도 좋은 아이디어가 될 수 있겠죠. 물론 이 부분은 다음 글에서 자세히 다룰 예정입니다. 😉

    오늘도 제 글이 여러분의 홈랩 운영에 작은 도움이 되었기를 바라며, 궁금한 점은 언제든 댓글로 남겨주세요! 13년차의 서버실은 언제나 여러분의 삽질을 응원합니다. 감사합니다!