완전한 애플리케이션 상태를 보존하는 방식으로 Home Assistant 데이터를 옮기고, 대체 인스턴스가 전체 검증을 통과할 때까지 기존 인스턴스를 그대로 유지하세요.
사용자와 설정은 눈에 보이는 YAML 파일만이 아니며, 대시보드를 복사해도 기록 데이터가 다시 만들어지는 것은 아닙니다. 마이그레이션할 때는 Home Assistant 구성 디렉터리 전체 또는 지원되는 백업, 기록이 중요하다면 Recorder 데이터베이스, 숨겨진 저장소, 비밀 정보, 커스텀 구성 요소와 그 주변의 런타임별 장치 및 네트워크 매핑을 보존해야 합니다. 가장 안전한 순서는 목록 작성, 일관된 복사, 격리된 환경에서 시작, 검증, 마지막으로 원본 폐기입니다.
이동 전에 영구 상태와 외부 종속 항목을 파악하세요
컨테이너 설치 환경에서는 익숙한 파일 몇 개만 골라 옮기기보다 마운트된 Home Assistant 구성 디렉터리 전체를 핵심 복구 단위로 간주하세요. .storage에 저장된 숨겨진 상태, 인증 데이터, 통합 레지스트리, 대시보드, 자동화, 기본 Recorder 데이터베이스가 모두 이 경로 아래에 있을 수 있습니다. 외부 MariaDB, MQTT, Zigbee 게이트웨이, 비밀 저장소, NAS 마운트는 별도로 목록에 기록해야 합니다.
Home Assistant 컨테이너 마이그레이션 안내는 파일별로 상태를 재구성하는 것보다 구성 디렉터리 전체를 이동하는 편이 안전한 이유를 보여 주며, 파일 시스템을 그대로 복사하기 전에 기존 컨테이너를 중지해야 한다고 강조합니다.
원본 경로, 대상 경로, 소유자 UID/GID, 데이터베이스 위치, USB 또는 시리얼 장치, 네트워크 모드, 공개 포트, 외부 서비스, 현재 Home Assistant 버전이 포함된 매니페스트를 만드세요. 종속 항목 중 하나라도 문서화되어 있지 않다면 기존 인스턴스를 삭제하지 마세요. 새 호스트가 문서화된 정보를 바탕으로 해당 종속 항목을 재현할 수 있을 때까지 마이그레이션 준비가 끝난 것이 아닙니다.
데이터를 복사하기 전에 일관된 롤백 지점 만들기
설치 환경에서 지원된다면 내장 백업이나 애플리케이션 상태를 고려한 다른 방법을 사용하세요. 원시 컨테이너 복사를 수행하는 경우, 활성 구성 데이터베이스와 관련 파일을 복사하기 전에 Home Assistant를 중지하세요. 실행 중인 상태를 그대로 복사하면 애플리케이션 파일이 서로 다른 시점의 상태로 저장될 수 있으며, 이는 통제된 마이그레이션과는 정반대입니다.
Home Assistant의 백업 기능 전면 개편으로 설치 방식 전반에서 복원 지원이 확대되었습니다. 따라서 지원되는 백업은 런타임을 변경할 때 강력한 이식성 경계가 됩니다. 설치 방식 간 백업 복원에서 얻을 수 있는 실질적인 교훈은 런타임은 바뀌어도 애플리케이션 상태는 연속성을 보장하는 경계로 유지된다는 점입니다.
사본을 두 개 보관하세요. 하나는 손대지 않은 이전 시점의 복구 지점으로, 다른 하나는 마이그레이션에 사용할 작업용 사본으로 두세요. 새 Home Assistant 인스턴스가 유일한 정상 원본 사본을 사용해 시작되지 않게 하세요. 대상 시스템이 마이그레이션을 수행하거나 새 레지스트리 상태를 기록한다면, 이전 버전과 이전 호스트로 되돌아갈 깨끗한 경로가 반드시 있어야 합니다.
런타임별 하드웨어 및 네트워크 매핑은 별도로 다시 구성하세요
애플리케이션 데이터가 호스트 장치 경로까지 자동으로 다시 만들어 주는 것은 아닙니다. Zigbee 또는 Z-Wave USB 코디네이터가 다른 장치 이름으로 표시될 수 있고, Bluetooth 액세스 방식이 다를 수 있으며, 호스트 네트워킹 변경으로 검색 기능이 달라질 수 있고, 외부 데이터베이스나 MQTT 브로커가 다른 주소를 통해 확인될 수 있습니다. 통합 항목을 데이터 손실로 판단하기 전에 이러한 인터페이스를 명시적으로 다시 구성하세요.
별도의 Container-to-HAOS 마이그레이션 안내서에서는 Home Assistant Core 상태를 복원해도 MQTT, Zigbee2MQTT 또는 Node-RED와 같은 사이드카 서비스가 자동으로 다시 만들어지지 않는다는 점을 보여 줍니다. 이 안내서의 사이드카 재매핑 마이그레이션 절차에서는 Recorder 기록의 연속성, USB 코디네이터 액세스, 롤백 경로로 사용할 중단 상태의 온전한 이전 스택도 확인합니다.
통제된 LAN 경로에서 대상 시스템을 시작하고, 의도적으로 격리하지 않는 한 두 인스턴스가 동일한 무선 장치, 웹훅, 클라우드 계정 또는 자동화를 함께 사용하지 않도록 하세요. 활성화된 Home Assistant 인스턴스 두 개가 중복 작업을 보내거나 동일한 코디네이터를 두고 경쟁하면, 올바르게 데이터를 마이그레이션했는데도 문제가 있는 것처럼 보일 수 있습니다.
전환 전에 사용자, 기록, 설정 및 장치 제어를 확인하세요
기존 비관리자 계정으로 로그인하고, 관리자 계정이 있는지 확인하고, 이전 시점보다 앞선 기록 그래프를 열어 보고, 통합 항목을 살펴보고, 대표적인 자동화를 실행하고, 중요한 프로토콜마다 장치 하나씩 확인하세요. 그런 다음 Home Assistant를 다시 시작하고 대상 호스트를 재부팅해 복구된 상태가 일반적인 수명 주기 이벤트 후에도 유지되는지 확인하세요.
관련된 ZimaSpace 설명인 Home Assistant 영구 데이터의 역할은 유용한 복구 기준을 제시합니다. 이전 작업 중에는 지속적으로 유지해야 하는 식별 정보, 구성, 기록을 캐시나 임시 파일과 다르게 취급해야 합니다.
DNS, 프록시 또는 원격 액세스 전환은 로컬 테스트를 통과한 후에만 진행하세요. 이전 호스트는 전원을 끈 상태로 유지하되, 최소 한 번의 일반 사용 주기 동안 복구할 수 있게 해 두세요. 사용자, 기록, 설정, 자동화, 무선 장치, 외부 서비스, 백업 생성 및 재부팅이 모두 예상대로 작동할 때만 이전 호스트를 폐기하세요. 대시보드가 처음으로 성공적으로 로드되었다는 사실만으로는 롤백 경로를 없애기에 충분하지 않습니다.
지원 및 팁
더 읽어보기

가족에게 NAS의 성인 동영상을 숨기는 방법
가족용 NAS에서 성인 동영상을 비공개로 보관하세요. 폴더 권한, Plex 및 Jellyfin 라이브러리 액세스 권한, 썸네일, 시청 기록, TV 공유 로그인 및 DLNA를 확인하세요.

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



