Home Assistant에 설정해야 할 메모리 한도는 얼마인가요?

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

Home Assistant에 언제나 적용되는 단일 메모리 한도는 없습니다. 직접 측정한 최대 사용량에 맞춰 한도를 설정하고, 호스트와 다른 컨테이너가 사용할 RAM을 남겨 두세요. OOM 종료가 발생하면 한도나 워크로드를 조사해야 한다는 신호로 여기세요.

여러 서비스가 함께 실행되는 홈 서버에서는 유휴 상태의 측정값만으로는 충분하지 않습니다. Recorder 작업, 백업, 통합 다시 불러오기, 대시보드, 집 전체의 바쁜 자동화 시퀀스에 따라 최대 사용량이 달라질 수 있습니다. 안전하게 설정하려면 기준 사용량을 기록하고, 검증된 워크로드 최대치보다 높은 값으로 되돌릴 수 있는 한도를 설정한 다음, 호스트에 여유 메모리가 남는지 확인하고, 설정을 영구 적용하기 전에 기존의 바쁜 시간대를 다시 테스트하세요.

일반적인 RAM 수치가 아니라 최대 사용량부터 확인하세요

일반적인 며칠 동안 Home Assistant 컨테이너와 호스트를 동시에 측정하세요. 재시작, 백업, 사용하는 경우 데이터베이스 정리 또는 재구성, 대시보드 활동, 안전하게 재현할 수 있는 가장 바쁜 자동화 시간대를 포함하세요. 컨테이너 최대 사용량, 호스트의 사용 가능 메모리, 스왑 사용량, 응답 시간 변화 여부를 기록하세요.

메모리 한도는 성능 목표가 아니라 cgroup 경계입니다. 컨테이너가 하드 한도를 넘으면 커널이 프로세스를 종료할 수 있습니다. 종료 코드 137과 OOM 종료 상태가 함께 나타나는 것이 대표적인 신호입니다. 따라서 평균 사용량이나 그대로 가져온 권장값보다 관측된 최대 사용량이 더 중요합니다.

작업 중 메모리 사용량이 늘었다가 안정된다면 반복적으로 나타나는 최대 사용량에 여유 공간을 더해 용량을 정하세요. 워크로드가 끝난 뒤에도 익명 메모리가 몇 시간 동안 계속 늘고 줄어들지 않는다면 용량 설정을 멈추고 메모리 누수가 있는 통합, 사용자 지정 구성 요소 또는 버전 회귀 문제를 조사하세요. 한도를 높이면 충돌을 늦출 수는 있어도 문제를 해결하지는 못합니다.

호스트와 함께 실행되는 모든 서비스를 위한 메모리 확보

Home Assistant 사용량이 가장 높을 때도 응답성을 유지해야 하는 서비스를 나열하세요. 운영 체제, Docker, 데이터베이스, MQTT, DNS, 대시보드, 미디어 서비스, 백업 작업 등이 해당됩니다. 한도는 Home Assistant뿐 아니라 이러한 서비스도 보호해야 합니다. 컨테이너 하나에 설치된 RAM을 거의 전부 할당하면 문제가 호스트로 옮겨갈 뿐입니다.

같은 시간대의 Home Assistant 최대 사용량과 호스트의 사용 가능 메모리를 비교하세요. 회수할 수 있는 캐시는 애플리케이션 메모리와 같지 않으며, 스왑이 작동하면 기기 제어가 느려지는 동안에도 시스템이 정상 작동하는 것처럼 보일 수 있습니다. Home Assistant가 최대 사용량에 도달하기 전에 호스트의 여유 메모리가 바닥난다면 Home Assistant의 한도를 낮추기 전에 동시에 실행되는 작업을 줄이거나 서비스를 다른 곳으로 옮기세요.

이는 단순한 Docker 설정이 아니라 용량을 결정하는 문제입니다. 웜 캐시를 넘어 Home Assistant를 측정하는 방법에 관한 관련 ZimaSpace 가이드에서는 반복 가능한 콜드 및 부하 상태의 워크로드가 편리한 유휴 상태 스냅샷보다 더 신뢰할 수 있는 기준을 제공하는 이유를 설명합니다.

되돌릴 수 있는 제한을 적용하고 실제로 적용되는지 확인

Compose 파일이나 오케스트레이션 UI처럼 컨테이너를 실제로 다시 생성하는 설정에 메모리 제한을 추가하세요. 다음 배포에서 사라질 수 있는 일회성 실시간 변경에 의존하지 마세요. 이전 설정을 저장해 두어 즉시 복구할 수 있게 하세요.

컨테이너를 다시 만든 뒤 실행 중인 컨테이너를 살펴보고 설정한 제한이 적용되었는지 확인하세요. 그런 다음 컨테이너 사용량, 호스트의 가용 메모리, 스왑, 재시작 횟수, 지연 시간을 지켜보세요. 호스트 cgroup에서 실제로 적용되지 않는 설정값은 특히 중첩 가상화 환경에서 잘못된 안도감을 줄 수 있습니다.

컨테이너가 재시작되더라도 자동으로 제한을 높이지 마세요. 런타임에 OOMKilled와 종료 코드 137이 보고되는지 확인하세요. 그렇지 않다면 다른 종료 경로를 조사하세요. 해당 메시지가 있다면 발생 시각을 워크로드와 비교하세요. 짧은 피크가 반복되면 작업 여유 공간이 부족한 것일 수 있고, 메모리가 꾸준히 증가하면 누수 또는 통합 구성 요소의 과도한 메모리 사용을 의심할 수 있습니다.

원래의 부하가 높은 Home Assistant 워크로드에서 재테스트

기준 측정에 사용한 시나리오를 그대로 반복하세요. 동일한 통합 구성 요소를 다시 불러오고, 같은 대시보드를 열고, 집 전체를 제어하는 동일한 순서를 실행한 뒤, 같은 백업 또는 Recorder 작업도 포함하세요. 워크로드를 바꾸면 더 가벼운 시스템이 작동한다는 사실만 확인하게 됩니다.

컨테이너에서 OOM 이벤트 없이 제한 범위 내의 메모리를 사용하고, 호스트에 사용 가능한 메모리가 남아 있으며, 스왑으로 제어 지연이 발생하지 않고, 자동화가 평소 속도로 완료되면 테스트를 통과한 것입니다. 컨테이너를 두 번 재시작한 뒤 다음 예약된 백그라운드 작업 이후에도 다시 확인해 재생성 및 시간 기반 작업에서도 문제가 없는지 확인하세요.

기기 제어가 불안정해지거나 컨테이너가 재시작 루프에 빠지거나 호스트의 메모리 압박이 계속 심하면 새 제한을 롤백하세요. 트리거가 된 워크로드가 끝난 뒤에도 메모리가 계속 증가한다면 통합 구성 요소를 분리하거나 버전을 비교해 원인을 찾으세요. 이 경우 제한 조정은 더 이상 주된 해결책이 아닙니다.

FAQ

Home Assistant에는 항상 메모리 제한을 걸어야 하나요? 공유 Docker 호스트에서는 테스트를 거친 제한을 설정해 다른 서비스를 보호할 수 있습니다. HAOS 전용 머신이나 VM은 크기 산정 기준이 다르므로, 전체 게스트 환경을 측정하지 않은 채 컨테이너 제한을 VM 할당량에 그대로 적용하지 마세요.

사용 중인 메모리가 많으면 무조건 메모리 누수인가요? 아닙니다. 캐시와 짧은 워크로드 피크는 정상일 수 있습니다. 익명 메모리가 계속 증가하는지, OOM 이벤트나 재시작 루프가 발생하는지, 워크로드가 끝난 뒤에도 지연 시간이 악화되는지 확인하세요.

스왑을 비활성화해야 하나요? 첫 조치로는 권장하지 않습니다. 먼저 스왑이 호스트 메모리 압박을 감추는지, 갑작스러운 장애를 막는지 확인한 다음, 충분한 물리 메모리로 전체 워크로드를 감당할 수 있고 검증된 롤백 경로가 있을 때만 변경하세요.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.