현재 영구 상태를 더 이상 신뢰할 수 있는 복구 원본으로 사용할 수 없고, 검증된 정상 백업으로도 설치를 복구할 수 없을 때만 Home Assistant를 재구축하세요. 대부분의 장애는 먼저 런타임, 통합 구성, 설정, 데이터베이스, 스토리지 또는 네트워크 문제로 분류한 뒤 가장 작은 범위에서 해결해야 합니다.
재설치가 곧 재구축을 의미하지는 않습니다. 컨테이너 이미지를 교체해도 /config는 그대로 유지될 수 있지만, 실제 재구축은 새 애플리케이션 상태를 만들고 통합 구성, 기기, 대시보드, 도우미 및 자동화를 복원하거나 다시 생성하는 작업을 감수하는 것입니다. 이 결정은 현재 증상에 대한 좌절감이 아니라 상태의 상황을 기준으로 내려야 합니다.
수리, 복원, 재구축을 서로 다른 작업으로 구분하세요
수리는 현재 설정을 유지하면서 문제가 발생한 구성 요소를 해결하는 것입니다. 복원은 손상되었거나 호환되지 않는 상태를 검증된 정상 백업으로 교체하는 것입니다. 재구축은 깨끗한 Home Assistant 설치에서 시작한 다음, 신뢰할 수 있다고 판단한 상태만 가져오거나 다시 만드는 것입니다.
이러한 구분은 컨테이너나 패키지 문제 때문에 불필요한 데이터 손실이 발생하는 것을 막아 줍니다. 현재 사용자, 영역, 기기 및 자동화가 여전히 존재한다면 새로 설치하는 과정에서 복구할 수 있는 정보보다 더 많은 정상 정보를 잃을 수 있습니다.
파일을 변경하기 전에 세 가지 작업 중 어떤 작업을 수행하는지 적어 두세요. 이 간단한 표시만으로도 수리 작업이 실수로 파괴적인 초기화로 넘어가는 것을 방지할 수 있습니다.
영구 상태가 여전히 일관적이라면 먼저 수리하세요
Home Assistant가 예상한 인스턴스를 열고, 설정 디렉터리에 파일이 있으며, 오류 원인을 특정 통합 구성, YAML 변경, 사용자 지정 구성 요소, 데이터베이스 파일, 마운트 또는 런타임 설정으로 좁힐 수 있다면 수리가 적절합니다.
많은 시작 오류는 설정을 포기하지 않고도 범위를 좁힐 수 있기 때문에 안전 모드와 복구 모드가 제공됩니다. 최신 복구 가이드에서는 정확한 시작 오류를 확인하고, 안전 모드로 사용자 지정 코드를 분리하며, 재구축 전에 최소한의 수리 경로로 복구 모드를 사용하는 방법을 권장합니다.
사용자 지정 통합 구성 하나를 비활성화하거나 업데이트하고, 잘못된 설정 항목 하나를 수정하거나, 스토리지 경로를 복구하거나, 런타임 버전을 이전 버전으로 되돌린 다음 다시 테스트하세요. 문제가 특정 범위에 한정되어 있는 동안에는 전체 설치를 초기화하지 마세요.
기록을 보존할 가치가 있을 때만 데이터베이스를 수리하세요
로그에 데이터베이스 오류가 가득 차면 Recorder 손상이 심각해 보일 수 있지만, Recorder 데이터베이스는 전체 Home Assistant 설정과 동일하지 않습니다. 현재 설정과 통합 구성이 온전하다면 새 기록 데이터베이스를 만드는 편이 전체 애플리케이션을 재구축하는 것보다 위험이 적을 수 있습니다.
기록이 중요하다면 실용적인 복구 안내서에서 Home Assistant를 중지하고 SQLite의 복구 도구를 사용해 손상된 Home Assistant 데이터베이스를 새 파일로 재구성하는 방법을 설명합니다.
복사본만 작업하고, 원본 손상 데이터베이스를 보존하며, 복구가 부분적으로만 이루어질 수 있음을 받아들이세요. 기록 복구에 실패했다고 해서 정상적인 자동화와 통합 구성을 버릴 이유는 없습니다.
계속 수리하는 것보다 검증된 정상 백업이 안전할 때 복원하세요
문제가 특정 업데이트나 수정 이후 시작되었고, 해당 변경 이전에 테스트된 백업이 있다면 복원하세요. 이는 여러 파일에 적용된 변경이나 부분적으로 변경된 파일 수십 개를 수동으로 되돌리는 것보다 빠르고 안전한 경우가 많습니다.
오랫동안 사용되어 온 Home Assistant 복원 가이드에서는 먼저 장애 원인을 해결한 다음 실패한 시스템에서 분리해 보관한 백업을 복원할 것을 권장합니다. 문제가 있는 전원 공급 장치, 디스크 문제, 잘못된 마운트 또는 호환되지 않는 런타임을 제거하지 않고 복원하면 동일한 장애가 다시 발생할 뿐입니다.
복원한 시스템이 정상 작동할 때까지 손상된 상태를 보존하세요. 손상된 상태에는 최근 자동화, 비밀 정보 또는 설정 변경 사항이 포함되어 있어 비교하거나 선택적으로 복구해야 할 수 있습니다.
상태와 복구 자료를 더 이상 신뢰할 수 없을 때 재구축하세요
설정 디렉터리가 없거나 광범위하게 손상되었고, 여러 백업이 복원 테스트에 실패하며, 런타임 정의를 알 수 없거나, 반복적인 수리 후에도 문서화되지 않아 재현할 수 없는 상태로 설치가 남아 있다면 깨끗한 재구축을 고려할 수 있습니다.
중요한 설정이 폐기 가능한 컨테이너 안에 갇혀 있는 경우처럼 구조가 잘못된 배포 환경에서 벗어날 때도 재구축이 더 깔끔한 선택일 수 있습니다. 단, 먼저 신뢰할 수 있는 모든 상태를 최대한 내보내야 합니다.
ZimaSpace의 로컬 자동화 가이드에서는 복구 가능성을 스마트 홈 플랫폼의 핵심 요구 사항으로 강조합니다. 새 설치를 이전에 포기한 상태보다 더 쉽게 백업하고 복원하며 운영할 수 있을 때에만 재구축이 성공했다고 할 수 있습니다.
기존 상태를 삭제하기 전에 결정표를 사용하세요
| 조건 | 권장 작업 |
|---|---|
| 단일 통합 구성 또는 설정 오류 | 수리 |
| 런타임 또는 이미지 업데이트 실패, 설정은 정상 | 런타임 수리 또는 롤백 |
| 데이터베이스 손상, 설정은 정상 | 데이터베이스 수리 또는 교체 |
| 광범위한 손상이 발생하기 전의 검증된 정상 백업이 있음 | 복원 |
| 설정과 백업을 신뢰하거나 재현할 수 없음 | 재구축 |
선택한 경로가 재시작과 일반적인 가정 내 사용 주기 한 번을 통과할 때까지 기존 설정, 데이터베이스 또는 백업 세트를 삭제하지 마세요.
자주 묻는 질문
Home Assistant 컨테이너를 다시 설치하면 재구축에 해당하나요?
아니요. 새 컨테이너가 동일한 영구 /config 디렉터리에 다시 연결된다면 런타임만 교체한 것이며, 동일한 설치 상태는 유지됩니다. 재구축은 새 상태에서 시작하거나 기존 상태를 의도적으로 포기하는 것입니다.
Recorder 데이터베이스가 손상되었다는 이유로 Home Assistant를 재구축해야 하나요?
대개 그렇지 않습니다. Recorder 기록은 Home Assistant의 나머지 부분과 별도로 수리하거나 복원하거나 교체할 수 있습니다. 기록뿐 아니라 설정과 복구 상태까지 더 이상 신뢰할 수 없을 때에만 전체 설치를 재구축하세요.
지원 및 팁
더 읽어보기

Home Assistant를 실행 중에 백업해야 할까요, 아니면 먼저 서비스를 중지해야 할까요?
내장된 Home Assistant 백업은 실행 중에도 진행할 수 있지만, 일반 파일 시스템 복사본을 만들 때는 데이터베이스가 일관되게 백업되지 않는 한 Home Assistant를 중지하거나 일시...

유휴 시간에 Home Assistant 서버가 뜨겁거나 시끄럽게 작동하는 이유는 무엇인가요?
냉각이나 CPU 제한을 변경하기 전에 Recorder, 백업, 통합 구성 요소 및 함께 실행되는 작업을 통해 Home Assistant의 팬 작동 또는 온도 급증 원인을 분석하세요.

Home Assistant가 백그라운드 작업을 위해 확보해야 하는 여유 저장 공간은 얼마나 될까요?
Home Assistant의 여유 공간은 일률적인 비율이 아니라 Recorder 데이터베이스, 백업 증가량, 유지 관리 시 최대 사용량, 복구 작업을 기준으로 산정하세요.

