Error: "invalid version of the configuration"

[thockin]

Welcome

• Yes, I'm using a binary release within 2 latest releases. Only such installations are supported.
• Yes, I've searched similar issues on GitHub and didn't find any.
• Yes, I've read the typecheck section of the FAQ.
• Yes, I've tried with the standalone linter if available (e.g., gocritic, go vet, etc.).
• I agree to follow this project's Code of Conduct

How did you install golangci-lint?

go install

Description of the problem

I get an error about config version, but I cannot find any docs about it:

$ go run github.com/golangci/golangci-lint/v2/cmd/[email protected] run -v
INFO golangci-lint has version v2.0.0 built with go1.24.1 from (unknown, modified: ?, mod sum: "h1:RQWk8VCuMQv9bBDy3x23yds2yf9aRZ86C9MWGIdNRuU=") on (unknown) 
INFO [config_reader] Config search paths: [./ /home/thockin/src/git-sync-v4 /home/thockin/src /home/thockin /home /] 
INFO [config_reader] Used config file .golangci.yaml 
INFO maxprocs: Leaving GOMAXPROCS=6: CPU quota undefined 
Error: invalid version of the configuration: ""
Failed executing command with error: invalid version of the configuration: ""
exit status 3

Version of golangci-lint

$ go run github.com/golangci/golangci-lint/v2/cmd/[email protected] --version
golangci-lint has version v2.0.0 built with go1.24.1 from (unknown, modified: ?, mod sum: "h1:RQWk8VCuMQv9bBDy3x23yds2yf9aRZ86C9MWGIdNRuU=") on (unknown)

Configuration

$ cat .golangci.yaml 
run:
  timeout: 30m

Go environment

$ go version && go env 
go version go1.24.1 linux/amd64
AR='ar'
CC='gcc'
CGO_CFLAGS='-O2 -g'
CGO_CPPFLAGS=''
CGO_CXXFLAGS='-O2 -g'
CGO_ENABLED='1'
CGO_FFLAGS='-O2 -g'
CGO_LDFLAGS='-O2 -g'
CXX='g++'
GCCGO='gccgo'
GO111MODULE=''
GOAMD64='v1'
GOARCH='amd64'
GOAUTH='netrc'
GOBIN=''
GOCACHE='/home/thockin/.cache/go-build'
GOCACHEPROG=''
GODEBUG=''
GOENV='/home/thockin/.config/go/env'
GOEXE=''
GOEXPERIMENT=''
GOFIPS140='off'
GOFLAGS=''
GOGCCFLAGS='-fPIC -m64 -pthread -Wl,--no-gc-sections -fmessage-length=0 -ffile-prefix-map=/tmp/go-build1274681100=/tmp/go-build -gno-record-gcc-switches'
GOHOSTARCH='amd64'
GOHOSTOS='linux'
GOINSECURE=''
GOMOD='/home/thockin/src/git-sync-v4/go.mod'
GOMODCACHE='/home/thockin/go/pkg/mod'
GONOPROXY=''
GONOSUMDB=''
GOOS='linux'
GOPATH='/home/thockin/go'
GOPRIVATE=''
GOPROXY='https://proxy.golang.org,direct'
GOROOT='/usr/local/go1.24.1'
GOSUMDB='sum.golang.org'
GOTELEMETRY='local'
GOTELEMETRYDIR='/home/thockin/.config/go/telemetry'
GOTMPDIR=''
GOTOOLCHAIN='auto'
GOTOOLDIR='/usr/local/go1.24.1/pkg/tool/linux_amd64'
GOVCS=''
GOVERSION='go1.24.1'
GOWORK=''
PKG_CONFIG='pkg-config'

Verbose output of running

$ go run github.com/golangci/golangci-lint/v2/cmd/[email protected] cache clean

$ go run github.com/golangci/golangci-lint/v2/cmd/[email protected] run -v
INFO golangci-lint has version v2.0.0 built with go1.24.1 from (unknown, modified: ?, mod sum: "h1:RQWk8VCuMQv9bBDy3x23yds2yf9aRZ86C9MWGIdNRuU=") on (unknown) 
INFO [config_reader] Config search paths: [./ /home/thockin/src/git-sync-v4 /home/thockin/src /home/thockin /home /] 
INFO [config_reader] Used config file .golangci.yaml 
INFO maxprocs: Leaving GOMAXPROCS=6: CPU quota undefined 
Error: invalid version of the configuration: ""
Failed executing command with error: invalid version of the configuration: ""
exit status 3

A minimal reproducible example or link to a public repository

Doesn't get this far

Validation

• Yes, I've included all information above (version, config, etc.).

Supporter

• I am a sponsor/backer through GitHub or OpenCollective

[ldez]

Hello,

the field version should be added: https://golangci-lint.run/product/migration-guide/#version

version: "2"

I recommend using the migration command: https://golangci-lint.run/product/migration-guide/#command-migrate

[thockin]

This does not seem to be in any of the examples or reference configs

[ldez]

The field is inside the reference file:

• golangci-lint/.golangci.reference.yml

  Line 7 in 6bac409

  version: "2"

• golangci-lint/.golangci.yml

  Line 14 in 6bac409

  version: "2"

But I can add an extra section about it.

[ldez]

I created a PR #5609

[thockin]

I must have looked at an old snap, sorry.

…

On Mon, Mar 24, 2025 at 12:39 PM Ludovic Fernandez ***@***.***> wrote: I created a PR #5609 <#5609> — Reply to this email directly, view it on GitHub <#5608 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ABKWAVAJBKO2465FU7YEX332WBNPLAVCNFSM6AAAAABZVWLYB6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDONBZGIYTENRZGE> . You are receiving this because you authored the thread.Message ID: ***@***.***> [image: ldez]*ldez* left a comment (golangci/golangci-lint#5608) <#5608 (comment)> I created a PR #5609 <#5609> — Reply to this email directly, view it on GitHub <#5608 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ABKWAVAJBKO2465FU7YEX332WBNPLAVCNFSM6AAAAABZVWLYB6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDONBZGIYTENRZGE> . You are receiving this because you authored the thread.Message ID: ***@***.***>