원문 캡처 · github.com
원문 캡처 · github.com

Vacuula는 고장 난 Neato 로봇청소기를 수리하고 제어하기 위한 자체 서버다. 지원 상태는 세대와 모델에 따라 다르며, 서버를 계속 켜 둘 전용 하드웨어가 필요하다.

  • Gen1: Wi-Fi 미지원
  • Gen2: BotVac Connected 지원 작업 중
  • Gen3: D3, D4, D5, D6, D7 지원
  • Gen4: D800, D8, D9, D10 지원

제작진은 초기 출시에서 기존 BotVac Connected를 지원하지 못했으며, 해당 모델 지원을 준비 중이라고 밝혔다. 지원 모델 목록에 없는 로봇은 Vacuula 저장소에 문의할 수 있다.

기능 지원 상태는 다음과 같다.

기능상태
설정·상태 확인지원
지도지원
과거 청소 기록지원
일정 예약지원
설정지원
구역·진입 금지선지원
알림개발 중
Home Assistant 엔티티개발 중
특정 위치를 지정해 청소개발 중
사용자 지정 소리개발 중
사용 편의성 개선개발 중
다음 날 일정 예약개발 중
다중 구역Gen4 지원, Gen2·Gen3 개발 중

Gen4 로봇이 여러 색으로 깜박이는 ‘레인보 모드’에 들어가 작동하지 않는 경우, 제작진은 Discord에서 수리 도움을 받을 수 있다고 안내한다.

서버 설치와 로봇 설정

수리 과정은 서버를 설정한 뒤 로봇을 구성하는 두 단계다. 초기 출시 시점에는 커뮤니티 서버가 준비되지 않아 사용자가 직접 서버를 설치해야 한다. 서버가 제대로 작동하려면 계속 켜져 있어야 하므로 전용 하드웨어가 필요하다. 장비가 없다면 FAQ의 하드웨어 안내를 참고할 수 있다.

Home Assistant를 사용하는 경우 제작진은 자체 앱 스토어 저장소를 통한 설치를 권장하고, 사용하지 않는 경우에는 Docker Compose를 권장한다. 서버 설치 방법은 다음과 같다.

Docker Compose로 설치하려면 Docker를 설치한 뒤 docker-compose.yaml을 내려받고 다음 명령을 실행한다. Docker 설치 안내는 FAQ에 있다.

sh
wget https://github.com/vacuula/vacuula/releases/latest/download/docker-compose.yaml
sh
docker compose up -d

서버는 환경 변수로 설정한다. 로그를 확인하거나 서버를 중지·시작하는 명령은 다음과 같다.

sh
docker compose logs vacuula
sh
docker compose down
sh
docker compose up -d

저장된 데이터를 영구 삭제하려면 먼저 Vacuula를 중지한 뒤 볼륨을 제거한다.

sh
docker volume rm vacuula-data

로봇 설정에는 제작진이 제공하는 설치 프로그램을 사용한다. 운영체제별 최신 설치 파일은 Windows, Linux, Apple Silicon(M1 이상) Mac, Intel 기반 Mac에서 받을 수 있다. 저장소에는 Windows 10·11과 macOS 15.4가 기재돼 있으며, 일부 운영체제와 로봇 세대의 호환 정보도 제시돼 있다. 다만 원문은 해당 호환 표의 항목을 명확하게 설명하지 않는다.

Linux에서는 사용자를 dialout 그룹에 추가한 뒤 컴퓨터를 재부팅해야 한다. 원문은 Windows 10·11에도 ‘need dialout’이라는 조건을 함께 기재한다.

sh
sudo usermod -aG dialout $USER

설치 프로그램의 소스 코드도 공개돼 있다. 설치 프로그램을 실행할 수 없는 특수한 환경이라면 제작진에게 문의할 수 있다.

포트와 서버 설정

서버와 웹앱은 기본적으로 포트 80을 사용하며, 이 포트는 변경할 수 있다. Gen3 로봇은 변경할 수 없는 포트 443을 요구한다. 이 포트를 사용하도록 설정하면 PWA가 작동하도록 Vacuula 서버와 웹앱도 포트 443에서 제공된다. Gen4 로봇은 변경할 수 있는 포트 3443을 사용한다.

포트용도
80서버·웹앱(변경 가능)
443Gen3 로봇, D3–D7(변경 불가)
3443Gen4 로봇, D8–D10(변경 가능)

서버 설정 환경 변수와 기본값은 다음과 같다.

옵션기본값설명
GEN4_PORT3443Gen4 로봇이 서버에 연결할 기본 포트
VACUULA_PORT80웹앱·API에 접속할 기본 포트
GEN3_ENABLEDTrueGen3 지원 여부. Gen3 기기는 포트 443이 필요하다.
GEN4_ENABLEDTrueGen4 지원 여부
MDNS_ENABLEDTrue자동 검색을 위한 mDNS 실행 여부

Vacuula는 현재 ARM 64비트와 x86 64비트에서만 테스트하고 지원을 확인했다. 제작진은 ARM 32비트도 지원하고, 가능하면 x86 32비트도 지원하기 위해 검토 중이라고 밝혔다. 구형 단일 보드 컴퓨터에서도 서버를 실행할 수 있도록 하는 것이 32비트 지원을 원하는 주된 이유다.