본문 바로가기

IT/IoT

[HA] HACS (Home Assistant Community Store) 설치

HA의 다양한 테마와 플러그인을 위한 HACS(Home Assistant Community Store)가 있습니다.

다양한 커스텀 카드나 테마를 편리하게 설치할 수 있게 해줍니다.

HACS를 설치하는 방법을 살펴보도록 하겠습니다.

 

설치를 위해 Home Assistant 0.98.0 이상GitHub 계정이 필요합니다.

먼저 HACS 파일을 다운로드하기 위해서 아래 링크로 이동합니다.

https://github.com/hacs/integration/releases

 

hacs/integration

Manage (Install, track, upgrade) and discover custom elements for Home Assistant. - hacs/integration

github.com

현재 기준으로 가장 최신 버전은 0.23.2으로 hacs.zip 파일을 받으면 됩니다.

압축을 해제하면 다음과 같이 디렉토리가 표시됩니다.

hacs 디렉토리

먼저 custom_components 디렉토리를 HA의 config 디렉토리에 생성합니다.

sudo mkdir -p /data/homeassistant/config/custom_components

경로는 실제 HA가 설치된 경로에 맞춰서 생성해주면 됩니다.

이제 custom_components에 hacs를 복사해줍니다.

파일 경로

위와 같은 경로로 config/custom_components/hacs로 위치하면 됩니다.

이제 HA 컨테이너를 재시작해주면 됩니다.

sudo docker restart home-assistant

다음으로 GitHub Access Token을 발급받아야 합니다.

아래의 주소로 접속해서 GitHub에 로그인을 합니다.

https://github.com/settings/tokens

 

Build software better, together

GitHub is where people build software. More than 40 million people use GitHub to discover, fork, and contribute to over 100 million projects.

github.com

GitHub 계정이 없다면 새로 생성해서 진행하면 됩니다.

토큰 생성

우측 상단에 보이는 Generate new token 버튼을 눌러서 생성합니다.

토큰 생성

적당한 이름을 입력한 이후에 Generate token을 누르면 생성됩니다.

Access Token

생성된 토큰의 우측에 보이는 복사 버튼을 클릭해서 해당 값을 별도로 저장합니다.

이 값은 창을 닫으면 다시 확인할 수 없기 때문에 텍스트 파일로 저장해두는 것을 추천합니다.

이제 HA를 켜고 Configuration > Integrations 메뉴로 이동합니다.

Integrations

우측 하단의 + 버튼을 누르고 HACS를 검색해서 추가합니다.

HACS

검색된 HACS (Home Assistant Community Store)를 누르면 상세 설정이 표시됩니다.

HACS 설정

GitHub Personal Access Token에 위에 생성한 토큰을 입력하고 SUBMIT을 클릭하면 됩니다.

Success!

위와 같이 Success! 팝업이 표시되면 Finish 버튼을 눌러서 창을 닫습니다.

HACS

좌측에 생성된 HACS 메뉴를 선택하고 CONTINUE를 계속 누르면 됩니다.

Home Assistant Community Store

이제 다양한 플러그인과 테마 등을 사용할 수 있게 됩니다.

설치를 원하는 모듈을 선택하고 설치를 하면 간단하게 설치가 됩니다.