quad-ops sync #

Synchronizes Docker Compose files from configured repositories with Podman Quadlet units on the local system.

Repositories are defined in the quad-ops config file as a list of Repository objects.

repositories:
  - name: quad-ops-compose
    url: https://github.com/trly/quad-ops-compose.git
    ref: main

Synopsis #

quad-ops sync [flags]

      --rollback   Rollback to the previous sync state
  -h, --help       help for sync

    --config string   Path to the configuration file
    --debug           Enable debug mode
    --verbose         Enable verbose output

The sync command is the core operation of Quad-Ops. It performs a complete synchronization cycle:

Repository Updates — Clone new repositories or pull latest changes
File Discovery — Scan for Docker Compose files in configured locations
Conversion — Generate Podman Quadlet units from compose configurations
Deployment — Write units to the quadlet directory
Stale Unit Cleanup — Stop, disable, and remove units no longer defined by any compose project
Image Pull — Pre-pull container images to avoid systemd start timeouts
Service Activation — Reload the systemd daemon and start container services

This command is safe to run repeatedly and will only make necessary changes.

Use --rollback to revert each repository to its previous commit and regenerate units. Services are restarted from the rolled-back configuration.

quad-ops sync

quad-ops sync --verbose

quad-ops sync --config /path/to/config.yaml

quad-ops sync --rollback