Page Inspect

GoReleaser - GoReleaser

GoReleaser

GoReleaser



Initializing search

goreleaser/goreleaser

- Getting Started
- Documentation
- More resources
- Pro
- News
- Sponsors

# Release engineering, simplified.

We handle the complexities of releasing so you can focus in building what really matters: **your software** - and it doesn't need to be written in Go!

Get started Pro

# Everything you need to release with confidence

GoReleaser does everything you need to create a professional release process for Go, Rust, TypeScript, Zig, and Python projects.

### Fast & Automated

From commit to a release in seconds - automate your entire workflow with a single command.

### Multiple Languages

First-class support for Go, Rust, TypeScript, Python, and Zig projects.

### Cross-Platform

Build and release for multiple platforms and architectures.

### Multiple Formats

Package your software exactly how your users want it - from binaries to Docker images and system packages.

### Security Made Easy

Release with confidence using built-in SBOM generation, code signing, and notarization.

### GitHub Actions and beyond

Works seamlessly with GitHub Actions, GitLab CI, and other popular CI/CD platforms.

### What's changed?

Keep users informed with auto-generated, customizable changelogs for every release.

### Let your users know

Announce releases to 𝕏, Slack, Discord, and more.

# Trusted by Industry Leaders

Join thousands of developers and companies who rely on GoReleaser for their mission-critical releases.

Google

Microsoft

AWS

Shopify

Uber

Splunk

Datadog

Hashicorp

GitHub

Grafana

Kubernetes

NGinx

GoReleaser

goreleaser/goreleaser

- Getting Started

Getting Started

- Introduction
- Install
- Quick Start
- How it works
- Limitations

Limitations

- CGO
- Semantic Versioning
- Documentation

Documentation

- Introduction
- General

General

- Project Name
- Metadata
- Dist folder
- Includes
- Templates
- Template Files
- Environment Variables
- Global Hooks
- Git
- Split & Merge
- Build

Build

- Introduction
- Builders

Builders

- Go
- Bun
- Rust
- Zig
- Deno
- Python
- UV
- Poetry
- Import pre-built binaries
- Build Hooks
- Verifiable Builds
- macOS Universal Binaries
- UPX
- Monorepo
- Package & Archive

Package & Archive

- Archives
- Source Archive
- Linux Packages
- Self-Extracting Archives
- App Bundles
- DMG
- MSI
- Checksums
- Snaps
- Chocolatey
- Docker (v2)
- Docker Images (deprecated)
- Docker Manifests (deprecated)
- Docker Digests
- Ko
- SBOMs
- Report Sizes
- Sign & Notarize

Sign & Notarize

- Binaries
- Archives, installers, packages, and checksums
- Docker Images and Manifests
- Notarize macOS applications
- Publish

Publish

- Hooks
- Release
- Snapshots
- Nightlies
- Blobs (s3, gcs, azblob)
- Cloudsmith
- Fury
- DockerHub
- Homebrew Casks
- Homebrew Formulas (deprecated)
- Winget
- NUR
- AUR
- AUR (Sources)
- NPM
- Krew
- Scoop
- Changelog
- HTTP Upload
- Artifactory
- Custom
- SCM

SCM

- GitHub
- GitLab
- Gitea
- Attestations
- Closing Milestones
- Announce

Announce

- Introduction
- Bluesky
- Discord
- LinkedIn
- Mastodon
- Mattermost
- OpenCollective
- Reddit
- Slack
- Email/SMTP
- Teams
- Telegram
- 𝕏/Twitter
- WebHooks
- Continuous Integration

Continuous Integration

- Introduction
- GitHub Actions
- Azure Pipelines
- CircleCI
- Cirrus CI
- Google CloudBuild
- Codefresh
- Drone
- GitLab CI
- Jenkins
- Semaphore
- Travis CI
- Woodpecker
- More resources

More resources

- Maintainers
- Users
- Deprecation notices
- Experimental features
- Common errors

Common errors

- Version-related configuration errors
- Git is in a dirty state
- Multiple tokens found, but only one is allowed
- GitHub release upload errors
- Docker build failures
- Build does not contain a main function
- Build Errors
- Resource not accessible by integration
- Changelog has only the latest commit
- Archive has different count of binaries for each platform
- Scoop requires single a windows archive
- Cookbooks

Cookbooks

- Introduction
- Blog Posts
- Add a new cookbook
- Building in a private monorepo, publishing in to a public repository
- Builds: using complex template environment variables
- Multi-platform Docker images
- Building Go modules
- Cross-compiling Go with CGO
- Use debconf and templates
- Publish to Artifactory using jfrog cli
- Publish to Nexus
- Release a library
- Semantic Release
- Setting a custom git tag
- Using the main.version ldflag
- Override hardcoded registry and image name ?
- Command Line Usage

Command Line Usage

- goreleaser
- goreleaser init
- goreleaser healthcheck
- goreleaser check
- goreleaser changelog
- goreleaser build
- goreleaser release
- goreleaser continue
- goreleaser publish
- goreleaser announce
- goreleaser completion
- goreleaser completion bash
- goreleaser completion fish
- goreleaser completion powershell
- goreleaser completion zsh
- goreleaser jsonschema
- Contributing
- Links
- Pro
- News

News

- Blog
- Archive

Archive

- 2025
- 2024
- 2023
- 2022
- 2021
- Categories

Categories

- announcements
- tutorials
- Sponsors



Made with 🩶 by the GoReleaser contributors