Installation
To install sops
, download one of the pre-built binaries provided for your platform from the artifacts attached to this release.
For instance, if you are using Linux on an AMD64 architecture:
# Download the binary
curl -LO https://github.com/getsops/sops/releases/download/v3.9.1/sops-v3.9.1.linux.amd64
# Move the binary in to your PATH
mv sops-v3.9.1.linux.amd64 /usr/local/bin/sops
# Make the binary executable
chmod +x /usr/local/bin/sops
Verify checksums file signature
The checksums file provided within the artifacts attached to this release is signed using Cosign with GitHub OIDC. To validate the signature of this file, run the following commands:
# Download the checksums file, certificate and signature
curl -LO https://github.com/getsops/sops/releases/download/v3.9.1/sops-v3.9.1.checksums.txt
curl -LO https://github.com/getsops/sops/releases/download/v3.9.1/sops-v3.9.1.checksums.pem
curl -LO https://github.com/getsops/sops/releases/download/v3.9.1/sops-v3.9.1.checksums.sig
# Verify the checksums file
cosign verify-blob sops-v3.9.1.checksums.txt \
--certificate sops-v3.9.1.checksums.pem \
--signature sops-v3.9.1.checksums.sig \
--certificate-identity-regexp=https://github.com/getsops \
--certificate-oidc-issuer=https://token.actions.githubusercontent.com
Verify binary integrity
To verify the integrity of the downloaded binary, you can utilize the checksums file after having validated its signature:
# Verify the binary using the checksums file
sha256sum -c sops-v3.9.1.checksums.txt --ignore-missing
Verify artifact provenance
The SLSA provenance of the binaries, packages, and SBOMs can be found within the artifacts associated with this release. It is presented through an in-toto link metadata file named sops-v3.9.1.intoto.jsonl
. To verify the provenance of an artifact, you can utilize the slsa-verifier
tool:
# Download the metadata file
curl -LO https://github.com/getsops/sops/releases/download/v3.9.1/sops-v3.9.1.intoto.jsonl
# Verify the provenance of the artifact
slsa-verifier verify-artifact <artifact> \
--provenance-path sops-v3.9.1.intoto.jsonl \
--source-uri github.com/getsops/sops \
--source-tag v3.9.1
Container Images
The sops
binaries are also available as container images, based on Debian (slim) and Alpine Linux. The Debian-based container images include any dependencies which may be required to make use of certain key services, such as GnuPG, AWS KMS, Azure Key Vault, and Google Cloud KMS. The Alpine-based container images are smaller in size, but do not include these dependencies.
These container images are available for the following architectures: linux/amd64
and linux/arm64
.
GitHub Container Registry
ghcr.io/getsops/sops:v3.9.1
ghcr.io/getsops/sops:v3.9.1-alpine
Quay.io
quay.io/getsops/sops:v3.9.1
quay.io/getsops/sops:v3.9.1-alpine
Verify container image signature
The container images are signed using Cosign with GitHub OIDC. To validate the signature of an image, run the following command:
cosign verify ghcr.io/getsops/sops:v3.9.1 \
--certificate-identity-regexp=https://github.com/getsops \
--certificate-oidc-issuer=https://token.actions.githubusercontent.com \
-o text
Verify container image provenance
The container images include SLSA provenance attestations. For more information around the verification of this, please refer to the slsa-verifier
documentation.
Software Bill of Materials
The Software Bill of Materials (SBOM) for each binary is accessible within the artifacts enclosed with this release. It is presented as an SPDX JSON file, formatted as <binary>.spdx.sbom.json
.
What's Changed
- Explicitly mark goreleaser's version, to avoid confusion with the Go version by @felixfontein in #1548
- build(deps): Bump the go group with 8 updates by @dependabot in #1550
- build(deps): Bump github/codeql-action from 3.25.10 to 3.25.11 in the ci group by @dependabot in #1551
- Fix the URL used for determining the latest SOPS version by @felixfontein in #1553
- build(deps): Bump the ci group with 4 updates by @dependabot in #1555
- build(deps): Bump the go group with 11 updates by @dependabot in #1554
- build(deps): Bump the go group with 10 updates by @dependabot in #1558
- build(deps): Bump the ci group with 3 updates by @dependabot in #1559
- build(deps): Bump the go group with 5 updates by @dependabot in #1562
- build(deps): Bump the ci group across 1 directory with 5 updates by @dependabot in #1564
- build(deps): Bump the go group with 4 updates by @dependabot in #1565
- build(deps): Bump github/codeql-action from 3.25.13 to 3.25.15 in the ci group by @dependabot in #1566
- build(deps): Bump github.com/docker/docker from 27.0.1+incompatible to 27.1.0+incompatible by @dependabot in #1568
- build(deps): Bump the go group with 5 updates by @dependabot in #1575
- build(deps): Bump the ci group with 2 updates by @dependabot in #1574
- build(deps): Bump github.com/docker/docker from 27.1.0+incompatible to 27.1.1+incompatible by @dependabot in #1581
- build(deps): Bump the ci group with 3 updates by @dependabot in #1584
- Note on the name of the configuration file by @ErraticMaker in #1569
- build(deps): Bump the ci group with 2 updates by @dependabot in #1586
- build(deps): Bump the go group across 1 directory with 15 updates by @dependabot in #1589
- build(deps): Bump the ci group with 2 updates by @dependabot in #1590
- build(deps): Bump the go group with 7 updates by @dependabot in #1593
- build(deps): Bump the ci group with 2 updates by @dependabot in #1592
- tests: ignore env var SOPS_AGE_KEY_FILE by @duthils in #1595
- build(deps): Bump the go group with 12 updates by @dependabot in #1602
- build(deps): Bump github.com/opencontainers/runc from 1.1.13 to 1.1.14 by @dependabot in #1603
- updatekeys subcommand: actually use option
--shamir-secret-sharing-threshold
by @felixfontein in #1608 - Added example of having age recipients in .sops.yaml by @felixfontein in #1607
- GitHub Actions linter for Rust formatting by @duthils in #1604
- github actions: set rust version globally by @duthils in #1612
- Fix
--config
being ignored byloadConfig
by @lopter in #1613 - build(deps): Bump the go group with 4 updates by @dependabot in #1618
- build(deps): Bump github/codeql-action from 3.26.6 to 3.26.7 in the ci group by @dependabot in #1619
- unit tests: add coverage for unset by @duthils in #1617
- sops_test: homogenize use of asserts by @duthils in #1622
- sops_test: add more tests on errors by @duthils in #1624
- Add 'check' task to CI that makes sure everything is green by @felixfontein in #1621
- build(deps): Bump the go group with 10 updates by @dependabot in #1629
- build(deps): Bump github/codeql-action from 3.26.7 to 3.26.8 in the ci group by @dependabot in #1628
- refactor: specify missing file in error message by @t3hmrman in #1625
- CI: Build with Go 1.22 and 1.23; update Vault to 1.14 by @reneleonhardt in #1531
- Allow edit subcommand to create files by @felixfontein in #1596
- Build release with Go 1.22.x by @felixfontein in #1615
- GHA: fix checkout action version by @felixfontein in #1630
- Do not encrypt if a key group is empty, or there are no key groups by @felixfontein in #1600
- updatekeys subcommand: show changes in shamir_threshold by @felixfontein in #1609
- Dependabot: fix config for Docker, add config for Rust/Cargo by @felixfontein in #1632
- build(deps): Bump the ci group with 2 updates by @dependabot in #1634
- build(deps): Bump the go group with 7 updates by @dependabot in #1635
- Add Cargo.lock for better reproducability of functional tests by @felixfontein in #1637
- build(deps): Bump the go group with 7 updates by @dependabot in #1639
- build(deps): Bump the rust group in /functional-tests with 5 updates by @dependabot in #1638
- Update all go deps with 'go get -t -u ./...' by @felixfontein in #1640
- Do not ignore errors when trying to parse a config file by @felixfontein in #1614
- Release 3.9.1 by @felixfontein in #1642
New Contributors
- @ErraticMaker made their first contribution in #1569
- @lopter made their first contribution in #1613
- @t3hmrman made their first contribution in #1625
- @reneleonhardt made their first contribution in #1531
Full Changelog: v3.9.0...v3.9.1