Home Assistant가 HACS를 마켓플레이스로 전환합니다: 달라지는 점을 모두 살펴보세요

Home Assistant를 한동안 사용해 오셨다면 HACS가 이미 설치되어 있을 가능성이 높습니다. Home Assistant Community Store는 Home Assistant에서 기본으로 제공하지 않는 커뮤니티 통합, 대시보드 카드, 테마를 추가할 때 가장 먼저 찾게 되는 곳입니다.

Home Assistant 2026.11부터 HACS가 새로운 이름인 Marketplace로 Core에 포함됩니다. 따로 설치할 필요가 없어집니다. 단순한 이름 변경이라고 생각할 수도 있지만, 무엇보다 커뮤니티에서 만든 모든 항목의 위상이 달라지는 일입니다.

누구나 설치하는 도구 HACS… 하지만 공식 도구는 아니었다

HACS는 워낙 널리 쓰여서 Home Assistant에 원래부터 포함되어 있었던 것처럼 느껴질 정도입니다. 하지만 그렇지 않습니다. 별도로 개발된 사용자 지정 통합으로, Core에 포함되지 않은 통합, 대시보드 카드, 테마 및 다양한 도구 등 커뮤니티 프로젝트를 이용할 수 있게 해 줍니다.

HACS가 없다면 GitHub에서 파일을 찾아 적절한 위치에 복사한 뒤, 새 버전이 나왔는지 직접 확인해야 합니다. HACS가 이 모든 일을 대신해 줍니다.

저는 이 모순이 늘 재미있었습니다. 수동 설치를 피하게 해 주는 도구를 정작 직접 설치해야 했으니까요. 2026.11부터는 이런 일이 없어집니다.

HACS가 Marketplace로 바뀝니다

Home Assistant 팀은 HACS를 Core에 직접 통합하면서, 처음 접하는 사용자도 이해하기 쉬운 이름인 Marketplace를 붙였습니다. 기본으로 활성화되는 Core 통합이며, 설정 > Marketplace에서 전용 인터페이스를 이용할 수 있습니다.

개발자들은 실용적인 접근 방식을 택했습니다. 가능한 한 적은 부분만 바꾸면서 HACS를 통합하기로 한 것입니다. 새로운 스토어를 처음부터 다시 만들지는 않았습니다. Marketplace는 HACS의 기반과 카탈로그, 그리고 주요 작동 방식을 그대로 이어받습니다.

HACS를 잘 알고 있다면 이름이 바뀌어도 낯설지 않을 겁니다.

무엇을 설치할 수 있을까요?

먼저 HACS에서 가장 흔히 사용하는 기능일 사용자 지정 통합을 찾을 수 있습니다. 아직 공식 통합이 없는 기기나 서비스를 지원하도록 추가하는 기능입니다. 그다음으로 대시보드용 플러그인과 카드, 테마, 사용자 지정 템플릿이 제공됩니다.

사용 방법은 달라지지 않습니다. 확장 기능을 검색하고, 설명을 읽고, 설치하면 이후 업데이트를 받을 수 있습니다.

제가 가장 반기는 변화는 설치한 저장소마다 자체 업데이트 엔터티가 생긴다는 점입니다. 새 버전이 Home Assistant 업데이트와 나란히 설정 > 업데이트에 표시됩니다. 이제 커뮤니티 확장 기능도 시스템의 다른 요소와 같은 방식으로 관리할 수 있습니다.

카탈로그를 이용할 때는 GitHub 계정이 필요 없습니다

공식 카탈로그를 둘러보고 그 안에 있는 항목을 설치할 때 더 이상 GitHub 계정을 연결할 필요가 없습니다. 카탈로그는 기존 HACS 카탈로그를 그대로 사용하지만, 등록된 버전은 GitHub API를 거치지 않고 해당 아카이브나 릴리스 파일에서 직접 다운로드됩니다.

카탈로그에 없는 사용자 지정 저장소를 이용하는 경우 등에는 여전히 GitHub 계정이 필요합니다. 링크를 사용해 저장소를 수동으로 추가하는 방법도 계속 이용할 수 있습니다. HACS의 인기 비결이었던 유연성은 그대로 유지되며, 카탈로그만 이용하는 사용자라면 한 단계를 덜 거치면 됩니다.

이미 HACS를 쓰고 있다면 어떻게 되나요?

누구나 궁금해할 만한 점입니다. 일반적으로 다시 설치할 필요는 없습니다.

Home Assistant 2026.11에서 처음 시작하면 Marketplace가 기존 HACS 설치를 가져옵니다. 설치된 저장소와 사용자 지정 저장소, 대시보드 리소스, 업데이트 엔터티가 모두 이전됩니다. 이후 기존 HACS 통합과 파일은 삭제됩니다.

기존 방식과의 호환성도 고려했습니다. /hacs 링크는 Marketplace로 리디렉션되며, 대시보드 파일은 기존 경로인 /hacsfiles/를 통해 계속 이용할 수 있습니다.

덕분에 11월 업데이트가 주말 내내 문제를 해결해야 하는 일로 번지는 것을 피할 수 있습니다.

경우에 따라 재시작이 필요 없습니다

다소 기술적인 변화지만 꽤 유용합니다. 이제 Home Assistant는 사용자 지정 통합을 설치한 뒤 통합 캐시를 새로 고칠 수 있습니다. 통합이 호환되는 설정 흐름을 지원하고 이미 로드된 상태가 아니라면 전체 시스템을 재시작하지 않아도 바로 사용할 수 있습니다.

그래도 재시작이 필요한 경우에는 Home Assistant가 복구 항목을 통해 알려줍니다.

각각만 보면 사소한 변화지만, 이런 변화가 모여 커뮤니티 확장 기능을 훨씬 편리하게 사용할 수 있게 해 줍니다.

주의: Marketplace가 공식이라고 해서 내용물까지 공식인 것은 아닙니다

제 생각에 가장 중요한 점입니다. Marketplace는 공식이지만, 그 안에 있는 항목은 공식이 아닙니다. Marketplace에서 배포되는 확장 기능은 여전히 커뮤니티가 작성하고 관리하는 코드입니다.

Home Assistant는 처음 사용할 때 경고를 표시하며, 설치나 업데이트를 진행하려면 관리자가 위험을 수락해야 합니다. 이는 당연한 조치입니다. 사용자 지정 통합은 Home Assistant 안에서 직접 실행되고, 사용자 지정 카드는 각 사용자의 브라우저에서 코드를 실행하기 때문입니다. 따라서 아무 GitHub 저장소나 무턱대고 설치하지 않는 편이 좋습니다.

그래도 안전장치는 마련되어 있습니다. 다운로드한 파일을 검사하고, 설치와 삭제는 지정된 디렉터리에서만 이루어지며, 설치를 승인하기 전에 여러 검증 절차를 거칩니다. 사용자 지정 통합이 기본 통합을 대체하는 경우에는 명시적으로 확인해야 합니다.

반면, 현재는 배포된 코드를 보장하기 위한 암호화 서명이나 체크섬이 없습니다. Marketplace는 설치를 간편하게 해 주지만, 모든 프로젝트를 감사하지는 않습니다.

위험한 확장 기능을 위한 비상 정지 버튼

카탈로그에서는 두 가지 경우를 구분합니다. 단순히 목록에서 제외된 저장소(관리 중단, 보관 처리 등)는 이미 설치한 사용자의 시스템에서 계속 작동합니다. 사용자에게는 알림이 표시되지만 더 이상 업데이트를 받을 수 없습니다.

위험하다고 판단되어 심각한 문제 항목으로 지정된 저장소는 훨씬 엄격하게 처리됩니다. Marketplace가 해당 저장소를 제거하고 Home Assistant를 재시작할 수 있습니다.

카탈로그는 시작할 때 확인하고, 이후 6시간마다 다시 확인합니다. 잠금장치, 경보 장치, 난방 또는 전기 설비 일부를 제어하는 소프트웨어라면 이처럼 신속하게 대응할 수 있다는 점은 결코 사치가 아닙니다.

HACS가 지원했지만 Marketplace에서는 지원하지 않는 항목

HACS는 AppDaemon 앱과 Python 스크립트도 관리했습니다. Marketplace에서는 이를 지원하지 않습니다.

이런 항목을 사용 중이라도 삭제되는 것은 없습니다. 파일은 그대로 남습니다. 다만 업데이트를 더 이상 추적하지 않으며, Home Assistant가 복구 항목을 통해 이 사실을 알려줍니다.

HACS를 통합과 Lovelace 카드 용도로 사용하는 대부분의 사용자에게는 달라지는 점이 없습니다.

블루프린트는 어떻게 되나요?

블루프린트는 Marketplace를 거치지 않습니다. GitHub 파일이나 Gist, Home Assistant 포럼 게시물 또는 온라인에 있는 YAML 파일 등 URL을 통해 계속 가져올 수 있습니다.

Home Assistant는 원본 주소를 기억하며, 다시 가져오기 기능을 사용하면 같은 위치에서 새 버전을 받을 수 있습니다. 다만 업데이트 엔터티는 없으므로 직접 확인해야 합니다.

원하는 항목을 찾기 쉽도록 카테고리 추가

Marketplace에는 또 다른 변화가 있습니다. 통합을 카테고리별로 분류하는 작업입니다. 공식 통합이 1,500개를 넘은 지금은 이름만으로 검색하기가 불편해졌습니다.

개발자들은 조명, 기후, 에너지, 전기차 충전 등 28개 카테고리를 정했으며, 일부는 하위 카테고리로 나뉩니다. 사용자 지정 통합은 manifest.json 파일에서 카테고리를 지정할 수 있고, Marketplace에 표시하는 기능도 이미 준비 중입니다.

앞으로는 이름을 몰라도 원하는 기능에 따라 확장 기능을 검색할 수 있게 될 것입니다. 초보자에게는 큰 변화입니다.

Core에 들어가기 전 단계일까요?

Home Assistant가 개발자에게 Marketplace를 소개하는 방식이 눈길을 끌었습니다. 통합이나 카드는 Marketplace에서 시작할 수 있습니다. 프로젝트가 성숙하고 사용자층을 확보해 실제로 유용한 기능을 제공하게 되면, 제작자는 Home Assistant 팀과 Core에 포함될 가능성을 논의할 수 있습니다.

따라서 Marketplace는 커뮤니티의 실험적인 프로젝트와 공식 기능 사이를 잇는 관문이 될 수 있습니다. 커뮤니티가 새로운 통합과 카드를 내놓는 속도를 보면, 꽤 괜찮은 생각 같습니다.

우리가 알던 HACS의 종말

HACS가 완전히 사라지는 것은 아닙니다. 위상이 바뀌는 것입니다. 카탈로그는 그대로 남고, 개발자들은 계속 hacs.json 파일을 사용하며, HACS 검증 도구도 시스템의 핵심으로 유지됩니다. Home Assistant는 Marketplace를 이렇게 설명합니다. 가능한 한 적은 부분만 바꿔 Home Assistant에 통합한 HACS라고요.

사용자에게는 거의 모든 면에서 긍정적인 변화입니다. 초보자도 HACS 설치 방법을 찾아 헤맬 필요가 없습니다. 업데이트가 다른 업데이트와 함께 표시되고, 설치가 간편해지며, 자동으로 이전되고, 인터페이스도 시스템에 포함됩니다.

다만 한 가지 주의할 점이 있습니다. Marketplace에서 다운로드한 확장 기능도 여전히 커뮤니티 확장 기능입니다. Home Assistant 팀이 관리하는 통합과 같은 수준의 보장을 제공하지는 않습니다.

수년 동안 Home Assistant를 설치한 뒤 가장 먼저 설치하라고 권하던 것이 HACS였습니다. 2026.11부터는 더 이상 그럴 필요가 없습니다. 그동안 HACS를 키워 온 분들에게는 정말 멋진 인정이네요!