1. 서론.

• ESPHome dashboard는 웹 기반의 인터페이스로, ESP8266 및 ESP32 칩을 사용하는 디바이스들을 손쉽게 설정하고 관리할 수 있는 도구입니다.

 

2. ESPHome dashboard on Docker.

2-1. 디렉토리 생성.

• Docker non-root user를 docker-user로 지정했습니다.
• 프레임워크 및 빌드 데이터가 컨테이너의 /config 디렉토리에 저장되므로, 데이터 유지를 위해 마운트 할 디렉토리를 생성해줍니다.

  $ su - dockerer
  $ mkdir -p ~/services/esphome/config
  $ cd ~/services/esphome
  

2-1. Compose 파일 작성 및 실행.

$ nano compose.yaml
    version: '3'
    services:
        esphome:
            image: ghcr.io/esphome/esphome:2024.9.0
            container_name: esphome
            restart: unless-stopped
            environment:
                - TZ=Asia/Seoul
                - LANG=ko_KR.UTF-8
                - LANGUAGE=ko_KR:ko:en_US:en
                - LC_ALL=ko_KR.UTF-8
                - USERNAME="로그인에 사용할 아이디"
                - PASSWORD="로그인에 사용할 비밀번호"
                - ESPHOME_DASHBOARD_USE_PING=true
            volumes:
                - ./config:/config
            ports:
                - 6052:6052
$ docker compose -f compose.yaml up -d

 

3. 접속.

• 웹 브라우저로 http://{dashboard IP}:6052 포트에 접속합니다. ex) http://192.168.123.123:6052
• compose.yaml에 지정한 아이디와 비밀번호로 로그인 하면 홈 화면으로 이동됩니다.