sync_user is no longer supported, since it is not needed. Us

Error message

sync_user is no longer supported, since it is not needed. Use sync_userid only please

What it means

Error "sync_user is no longer supported, since it is not needed. Use sync_userid only please" thrown in EugenMayer/docker-sync.

Source

Thrown at lib/docker-sync/sync_strategy/native_osx.rb:40

        # if a custom image is set, apply it
        @docker_image = @options.key?('image') ? @options['image'] : 'ghcr.io/eugenmayer/unison:2.52.1-4.12.0'

        begin
          Dependencies::Docker.ensure!
        rescue StandardError => e
          say_status 'error', "#{@sync_name} has been configured to sync with native docker volume, but docker is not found", :red
          say_status 'error', e.message, :red
          exit 1
        end
      end

      def start_container
        say_status 'ok', "Starting native_osx for sync #{@sync_name}", :white
        container_name = get_container_name
        host_sync_src = File.realpath(@options['src'])
        volume_app_sync_name = @sync_name
        env = {}
        raise 'sync_user is no longer supported, since it is not needed. Use sync_userid only please' if @options.key?('sync_user')

        env['UNISON_SRC'] = '/host_sync'
        env['UNISON_DEST'] = '/app_sync'

        env['UNISON_ARGS'] = ''
        if @options.key?('sync_args')
          sync_args = @options['sync_args']
          sync_args = @options['sync_args'].join(' ') if @options['sync_args'].kind_of?(Array)
          env['UNISON_ARGS'] = sync_args
        end

        ignore_strings = expand_ignore_strings
        env['UNISON_ARGS'] << ' ' << ignore_strings.join(' ')
        env['UNISON_ARGS'] << ' ' << sync_prefer
        env['UNISON_ARGS'] << ' -numericids -auto -batch'
        env['UNISON_WATCH_ARGS'] = '-repeat watch'

        env['MAX_INOTIFY_WATCHES'] = @options['max_inotify_watches'] if @options.key?('max_inotify_watches')

View on GitHub (pinned to 4eab6de164)

Solutions

Remove the deprecated sync_user option from docker-sync.yml
Use sync_userid instead, e.g. sync_userid: 'from_host' to map to your host user id

Example fix

sync_options:
  sync_userid: 'from_host'

When it happens

Trigger: Thrown at lib/docker-sync/sync_strategy/native_osx.rb:40 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/0db069d2d1adcbf0. Report an issue: GitHub.