EugenMayer/docker-sync · error

for now, rsync does no longer support groupid, but for nearl

Error message

for now, rsync does no longer support groupid, but for nearly all cases sync_userid should be enough

What it means

Error "for now, rsync does no longer support groupid, but for nearly all cases sync_userid should be enough" thrown in EugenMayer/docker-sync.

Source

Thrown at lib/docker-sync/sync_strategy/rsync.rb:150

        say_status 'ok', "#{container_name}: starting initial sync of #{@options['src']}", :white if @options['verbose']

        health_check
        sync
        say_status 'success', 'Rsync server started', :green
      end

      def get_user_mapping
        user_mapping = ''
        if @options.key?('sync_userid')
          user_mapping = "#{user_mapping} -e OWNER_UID=#{@options['sync_userid']}"
        end
        return user_mapping
      end

      def get_group_mapping
        group_mapping = ''
        if @options.key?('sync_groupid')
          raise 'for now, rsync does no longer support groupid, but for nearly all cases sync_userid should be enough'
          #group_mapping = "#{group_mapping} -e GROUP_ID=#{@options['sync_groupid']}"
        end
        return group_mapping
      end

      def get_docker_env
        env_mapping = []
        env_mapping << "-e VOLUME=#{@options['dest']}"
        env_mapping << "-e TZ=$(basename $(dirname `readlink /etc/localtime`))/$(basename `readlink /etc/localtime`)"
        env_mapping << "-e ALLOW=#{@options['sync_host_allow']}" if @options['sync_host_allow']
        env_mapping.join(' ')
      end

      def stop_container
        `docker ps | grep #{get_container_name} && docker stop #{get_container_name}`
      end

      def reset_container

View on GitHub (pinned to 4eab6de164)

Solutions

  1. Remove sync_groupid from the rsync sync configuration
  2. Use only sync_userid for ownership mapping; it covers nearly all permission use cases
  3. If group mapping is mandatory, switch to a strategy that supports groups

Example fix

sync_options:
  sync_userid: 'from_host'

When it happens

Trigger: Thrown at lib/docker-sync/sync_strategy/rsync.rb:150 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of EugenMayer/docker-sync@4eab6de164 (2026-08-23). Data as JSON: /api/errors/b8421623731ad31e. Report an issue: GitHub.