{"id":25903891,"url":"https://github.com/brezuicabogdan/homeassistant-docker-compose-control","last_synced_at":"2026-05-05T14:10:47.005Z","repository":{"id":280170175,"uuid":"941174218","full_name":"brezuicabogdan/homeassistant-docker-compose-control","owner":"brezuicabogdan","description":"**Home Assistant Docker Compose Control (DCC)** is a custom integration for Home Assistant that allows you to **monitor and manage Docker Compose deployments** directly from the Home Assistant UI.","archived":false,"fork":false,"pushed_at":"2025-03-01T18:15:22.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-01T18:32:55.678Z","etag":null,"topics":["docker","docker-compose","home-assistant","homeassistant-integration"],"latest_commit_sha":null,"homepage":"https://github.com/brezuicabogdan/homeassistant-docker-compose-control","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brezuicabogdan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-01T17:04:43.000Z","updated_at":"2025-03-01T18:15:25.000Z","dependencies_parsed_at":"2025-03-01T18:32:57.713Z","dependency_job_id":"6d2c098f-d6c4-4628-87a4-c962e6decb8b","html_url":"https://github.com/brezuicabogdan/homeassistant-docker-compose-control","commit_stats":null,"previous_names":["brezuicabogdan/homeassistant-docker-compose-control"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brezuicabogdan%2Fhomeassistant-docker-compose-control","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brezuicabogdan%2Fhomeassistant-docker-compose-control/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brezuicabogdan%2Fhomeassistant-docker-compose-control/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brezuicabogdan%2Fhomeassistant-docker-compose-control/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brezuicabogdan","download_url":"https://codeload.github.com/brezuicabogdan/homeassistant-docker-compose-control/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241605820,"owners_count":19989612,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-compose","home-assistant","homeassistant-integration"],"created_at":"2025-03-03T04:16:13.901Z","updated_at":"2025-10-30T03:13:37.424Z","avatar_url":"https://github.com/brezuicabogdan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Home Assistant Docker Compose Control (DCC)\n\n## 📌 About\n\n**Home Assistant Docker Compose Control (DCC)** is a custom integration for **Home Assistant** that allows you to **monitor and manage Docker Compose deployments** directly from the Home Assistant UI.\n\n### 🔹 Features\n\n- 🏠 **Device \u0026 Entity Creation**: Each Docker Compose project is registered as a device, with each service appearing as an entity.\n- 📊 **Real-time Monitoring**: Track the status of each service (running, stopped, exited, etc.).\n- 🩺 **Health Status \u0026 Attributes**: View additional container details like **health status, restart count, image version, and uptime**.\n- 🔄 **Service Restarting**: Restart individual services directly from Home Assistant.\n- 🛠 **Seamless Integration**: Works with Home Assistant's UI and automation engine.\n\n---\n\n## ❓ Why?\n\n### **Bridging the Gap for Docker \u0026 Docker Compose Users**\n\nHome Assistant users running **HassOS** benefit from a built-in **Supervisor** and **Add-ons**, allowing them to easily manage services like **ESPHome, Mosquitto, Zigbee2MQTT, and more** from within Home Assistant.\n\nHowever, users running Home Assistant in **Docker** or **Docker Compose** **do not have access** to these built-in management tools. This results in:\n\n- **Manual intervention** required to restart or update services.\n- **No centralized way** to monitor running services.\n- **Lack of Home Assistant integration**, making automation difficult.\n\nThis integration was created to **bring similar functionality to Docker Compose users**, allowing them to **monitor and manage their services** **directly from the Home Assistant UI**, just like HassOS users do with Add-ons and the Supervisor.\n\n---\n\n## 🚀 Installation\n\n### **1️⃣ Install via HACS (Recommended)**\n\n1. Open **HACS** in Home Assistant.\n2. Go to **Integrations**.\n3. Click the **+ (Add Integration)** button.\n4. Search for **Docker Compose Control (DCC)** and install it.\n5. Restart Home Assistant.\n6. Go to **Settings → Devices \u0026 Services → Add Integration** and search for **Docker Compose Control**.\n7. Provide the **Docker socket path** and the **Docker Compose file path** to set up the integration.\n\n### **2️⃣ Manual Installation**\n\n1. Download the latest release from the [**GitHub Releases**](https://github.com/brezuicabogdan/homeassistant-docker-compose-control) page.\n2. Extract and place the `custom_components/dcc` folder inside your Home Assistant `config/custom_components/` directory.\n   ```bash\n   mkdir -p /config/custom_components/dcc\n   cp -r dcc /config/custom_components/\n   ```\n3. Restart Home Assistant.\n4. Add the integration via **Settings → Devices \u0026 Services**.\n\n---\n\n## ⚙️ Configuration\n\n### 🛠️ Prerequisites\n\nBefore configuring this integration, ensure that:\n\n- The **Docker socket** (`/var/run/docker.sock`) and the **Docker Compose file** (e.g., `/opt/home-automation/docker-compose.yml`) are correctly mapped into your Home Assistant container.\n- Home Assistant has the necessary permissions to access the Docker socket.\n\n#### 🔹 Example: Home Assistant in Docker Compose with Required Mappings\n\nIf you are running Home Assistant inside a **Docker container**, ensure your `docker-compose.yml` includes these volume mappings:\n\n```yaml\ndocker-compose:\n  homeassistant:\n    image: \"ghcr.io/home-assistant/home-assistant:latest\"\n    container_name: homeassistant\n    restart: unless-stopped\n    volumes:\n      - /path/to/your/config:/config\n      - /var/run/docker.sock:/var/run/docker.sock  # Map Docker socket\n      - /opt/home-automation/docker-compose.yml:/containers/docker-compose.yml  # Map Compose file\n    network_mode: host\n    environment:\n      - TZ=Europe/Bucharest\n```\n\nMake sure to replace `/path/to/your/config`, `/var/run/docker.sock`, and `/opt/home-automation/docker-compose.yml` with your actual paths. Once installed, configure the integration by providing:\n\n- **Docker Socket Path** (e.g., `/var/run/docker.sock`)\n- **Docker Compose File Path** (e.g., `/opt/home-automation/docker-compose.yml`)\n\nEach Docker Compose project will be registered as a **device**, with each service appearing as an **entity** under that device.\n\n---\n\n## 🔧 Usage\n\n### **Entities \u0026 Attributes**\n\nEach Docker service entity provides:\n\n- **State**: `running`, `stopped`, `exited`, etc.\n- **Health Status**: `healthy`, `unhealthy`, `starting`, or `unknown`.\n- **Restart Count**: How many times the service has restarted.\n- **Image**: The current Docker image version.\n- **Uptime**: Start time of the container.\n\n### **Service Control**\n\n- Restart a service via Home Assistant **Developer Tools → Services**:\n  ```json\n  {\n    \"entity_id\": \"sensor.docker_homeassistant\"\n  }\n  ```\n\n---\n\n## 🛣️ Project Roadmap\n\nThis project aims to provide full integration of Docker Compose into Home Assistant, making it easy to monitor and manage services. The following features are planned:\n\n1️⃣ **Home Assistant Integration of Docker Compose Deployments** ✅ (Done)\n\n- Each Docker Compose project appears as a device in HA.\n- Each service is registered as an entity.\n\n2️⃣ **Service Status Monitoring** ✅ (Done)\n\n- Track container states (`running`, `stopped`, `exited`, etc.).\n- Monitor container health (`healthy`, `unhealthy`, `starting`).\n\n3️⃣ **Restart Services from Home Assistant** ✅ (Done)\n\n- Restart services directly from the HA UI or via automation.\n\n4️⃣ **Container Update Notifications** 🛠️ (Planned)\n\n- Detect if an updated image is available for a service.\n- Send HA notifications when updates are detected.\n\n5️⃣ **Update Containers from Home Assistant** 🛠️ (Planned)\n\n- Allow updating containers directly from HA.\n- Trigger `docker-compose pull` and `docker-compose up -d` commands.\n\n---\n\n## ⚠️ Disclaimer\n\n**This integration is provided \"as is\" without any guarantees.**\n\n- **Use at your own risk.** We are not responsible for any misconfigurations that may cause issues.\n- Ensure that **your Home Assistant instance has the correct permissions** to access Docker.\n- Running Docker as `root` may pose security risks; consider using user-level access where possible.\n\n---\n\n## 🤝 Contributions\n\nWant to improve this project? Contributions are welcome! 🛠️\n\n### **How to Contribute**\n\n1. Fork the repository.\n2. Create a new feature branch.\n3. Make your changes and commit.\n4. Open a pull request.\n\n### **Support \u0026 Discussion**\n\n- Open an **issue** on [GitHub Issues](https://github.com/brezuicabogdan/homeassistant-docker-compose-control/issues) if you encounter problems.\n- Join the **Home Assistant Community** forums for discussion.\n\n---\n\n## 📜 License\n\nThis project is open-source and available under the **MIT License**.\n\n🚀 **Enjoy managing Docker Compose services within Home Assistant!** 🎉\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrezuicabogdan%2Fhomeassistant-docker-compose-control","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrezuicabogdan%2Fhomeassistant-docker-compose-control","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrezuicabogdan%2Fhomeassistant-docker-compose-control/lists"}