Having small binary sizes are important, and Go is known for generating rather big binaries.
GoReleaser has had
-s -w as default
ldflags since the beginning, which help shaving off some bytes, but if you want to shave it even more,
upx is the de facto tool for the job.
GoReleaser has been able to integrate with it via custom build hooks, and now UPX has its own configuration section:
upx does not support all platforms! Make sure to check their issues and to test your packed binaries first.
Namely, macOS Ventura is not supported at the moment.
Future GoReleaser releases will add more filters so you can cherry-pick which platforms you want to pack or not.
# .goreleaser.yaml upx: - # Whether to enable it or not. enabled: true # Filter by build ID. ids: [ build1, build2 ] # Filter by GOOS. # # Since: v1.19 goos: [ linux , darwin ] # Filter by GOARCH. # # Since: v1.19 goarch: [ arm, amd64 ] # Filter by GOARM. # # Since: v1.19 goarm: [ 8 ] # Filter by GOAMD64. # # Since: v1.19 goamd64: [ v1 ] # Compress argument. # Valid options are from '1' (faster) to '9' (better), and 'best'. compress: best # Whether to try LZMA (slower). lzma: true # Whether to try all methods and filters (slow). brute: true
Notice you can define multiple
upx definitions, filtering by various fields. You can use that to have different compression options depending on the target OS, for instance - or even to run it only on a few selected platforms.
upx is not in
$PATH, GoReleaser will automatically avoid running it.