localrivet/dosync repository overview

⁠DOSync - Docker Compose Service Synchronization Tool

⁠🚀 Overview

DOSync is a powerful, lightweight tool that automatically synchronizes changes from your Docker Compose files to running containers. Stop manually restarting containers after configuration changes!

⁠✨ Features

• Real-time Monitoring: Continuously watches your Docker Compose files for changes
• Selective Updates: Only restarts services that actually need updating
• Configuration Backups: Automatically backs up configurations before changes
• Rollback Support: Easily revert to previous versions if needed
• Multi-platform Support: Runs on Linux (amd64/arm64/armv7) and macOS
• Low Resource Footprint: Designed for efficiency, even on resource-constrained systems
• Web Dashboard: Built-in monitoring interface to track sync operations
• Notification System: Get alerts when services are updated
• Secure: No unnecessary privileges, runs with minimal permissions

⁠🔧 Quick Start

version: '3'
services:
  dosync:
    image: localrivet/dosync:latest
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./docker-compose.yml:/app/docker-compose.yml
    environment:
      - SYNC_INTERVAL=30s
      - VERBOSE=true
    restart: unless-stopped

⁠📘 Configuration Options

⁠💡 Common Use Cases

• GitOps Workflows: Pair with Git to automatically apply changes when repos update
• Configuration Management: Keep services in sync with external configuration systems
• Development Environments: Speed up development by automatically applying changes
• Self-hosted Applications: Ensure configurations stay in sync across multiple services

⁠🔒 Security

DOSync is designed with security in mind:

• Only requires access to the Docker socket (read/write)
• No external network dependencies
• All operations logged for audit purposes
• Configuration backups are stored locally

⁠🔄 Versioning

• latest: Always points to the most recent stable release
• vX.Y.Z: Specific version tags for production environments
• All images are multi-platform: Linux (amd64, arm64, armv7)

⁠📦 Related Projects

• ECRSync⁠: Automatically sync images from ECR
• DOSyncUI⁠: Advanced web UI for DOSync

GitHub⁠ | Documentation⁠ | Issues⁠