Download
tip
Seata Go v2.0.0 is the current stable release, covering AT, TCC, and XA modes with registry options for file, Nacos, and Etcd.
System Requirements
| Item | Requirement / Notes |
|---|---|
| Go toolchain | Go 1.20 or newer with modules enabled (go env GOPATH configured) |
| Seata Server | Seata Server 2.5.0+ reachable from your services (HTTP/2 enabled by default in 2.5.0) |
| Registry / Config | File, Nacos, or Etcd v3 registry; optional config center via file or Nacos |
| Database | MySQL 5.7/8.0 for AT & XA; Oracle supported through go-ora (XA) |
| Operating system | Linux, macOS, Windows (amd64/arm64) |
Stable Version
| Version | Source | Binary | Release Notes | Reference Docs |
|---|---|---|---|---|
| 2.0.0 | apache-seata-go-2.0.0-incubating-src.tar.gz ASC SHA512 | apache-seata-go-2.0.0-incubating-bin.tar.gz ASC SHA512 | v2.0.0 changelog | Samples & docs |
- For upgrade guidance, follow the project README and keep module dependencies in sync with Seata Server.
- Older releases are available from the Seata Go archive.
Install via Go Modules
- (Optional) Pin a proxy for faster downloads:
go env -w GOPROXY=https://goproxy.cn,direct. - Add the SDK to your module:
go get seata.apache.org/seata-go@v2.0.0(records togo.mod/go.sum). - Lock the dependency explicitly by keeping
require seata.apache.org/seata-go v2.0.0and runninggo mod tidy. - Verify dependency integrity before committing:
go list seata.apache.org/seata-go/....
Verify the releases
It is crucial to verify the integrity of downloaded artifacts using GPG signatures or SHA checksums. Download the KEYS, .asc, and .sha512 files directly from the Apache distribution directory rather than mirrors.
Verify Signatures
- Download the signatures KEYS and the desired release files with their
.ascsignatures. - Import the public keys:
gpg --import KEYS - Validate each artifact, for example:
A result similar to the following indicates a valid signature:
gpg --verify apache-seata-go-2.0.0-incubating-src.tar.gz.asc apache-seata-go-2.0.0-incubating-src.tar.gz
gpg --verify apache-seata-go-2.0.0-incubating-bin.tar.gz.asc apache-seata-go-2.0.0-incubating-bin.tar.gzgpg: Signature made Tue Apr 29 12:11:09 2025 CST
gpg: using RSA key 775377BF271D659E591249CD63E269707E8BF0FB
gpg: Good signature from "xxx" [ultimate]
Verify Checksums
- Download the
.sha512file corresponding to the artifact. - Run the checksum validation:
Output ending with
shasum -c apache-seata-go-2.0.0-incubating-src.tar.gz.sha512
shasum -c apache-seata-go-2.0.0-incubating-bin.tar.gz.sha512OKconfirms the archive is intact.
Additional Resources
- Seata Go repository: apache/incubator-seata-go
- Go samples: apache/incubator-seata-go-samples
- Configuration reference:
pkg/client/config.go - Transaction mode overview: Seata documentation