Homekit Docker Standup

This is a docker-compose configuration to run home automation and bridge services on a Synology NAS, allowing you to connect non-HomeKit devices to Apple Home.

🚀 Services

Service	Description
Homebridge	Connects non-HomeKit Smart Home devices to Apple HomeKit.
Matterbridge	A bridge that exposes non-Matter devices to HomeKit via the Matter protocol.
Scrypted	High-performance video integration for cameras into HomeKit (HKSV).

📋 Prerequisites

• Synology NAS (DSM 7.x recommended)
• Git installed via SynoCommunity
• Docker / Container Manager
• Docker Compose

🛠️ Setup

1. Clone the project:

   git clone https://gitlab.com/thinkonezero/homekit-docker-standup.git

2. Environment Configuration:
   • Copy sample.env to .env.
   • Update SYNOLOGY_BASE_DOCKER_PATH to your docker root (e.g., /volume1/docker).
   • Set your PUID and PGID (run id via SSH).
3. Deploy:

   docker-compose up -d

🌐 Accessing Apps

Note: These services run in host network mode for better device discovery.

App	Default URL
Homebridge	http://<NAS_IP>:${HOMEBRIDGE_UI_PORT}
Matterbridge	http://<NAS_IP>:8283
Scrypted	https://<NAS_IP>:10443

⚙️ Environment Variables

Common variables used across services:

• PUID/PGID: Local user/group IDs.
• TZ: Your timezone (e.g., Europe/London).
• LOG_FILE_NUM/SIZE: Settings for Docker log rotation.

---

If this project has helped you, please consider supporting my work!

---

Disclaimer

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY.