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:

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:

Verify binary integrity

To verify the integrity of the downloaded binary, you can utilize the checksums file after having validated its signature:

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.12.2.intoto.jsonl. To verify the provenance of an artifact, you can utilize the slsa-verifier tool:

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.12.2
• ghcr.io/getsops/sops:v3.12.2-alpine

Quay.io

• quay.io/getsops/sops:v3.12.2
• quay.io/getsops/sops:v3.12.2-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:

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 .spdx.sbom.json.

What's Changed

• CI: Rearrange steps; disable setup-go's caching by @felixfontein in #2081
• build(deps): Bump the go group with 6 updates by @dependabot[bot] in #2085
• build(deps): Bump the ci group with 2 updates by @dependabot[bot] in #2084
• build(deps): Bump github.com/cloudflare/circl from 1.6.1 to 1.6.3 by @dependabot[bot] in #2087
• build(deps): Bump go.opentelemetry.io/otel/sdk from 1.39.0 to 1.40.0 by @dependabot[bot] in #2089
• build(deps): Bump the ci group with 4 updates by @dependabot[bot] in #2091
• build(deps): Bump tempfile from 3.25.0 to 3.26.0 in /functional-tests in the rust group by @dependabot[bot] in #2090
• build(deps): Bump github.com/docker/cli from 28.0.4+incompatible to 29.2.0+incompatible by @dependabot[bot] in #2095
• build(deps): Bump the ci group with 4 updates by @dependabot[bot] in #2101
• Check for metadata key(s) before re-encrypting file by @felixfontein in #2098
• fix: handle mac only encrypted flag in global by @CzBiX in #2100
• sops edit: delete temporary file on termination by @felixfontein in #2104
• build(deps): Bump the ci group with 4 updates by @dependabot[bot] in #2106
• build(deps): Bump tempfile from 3.26.0 to 3.27.0 in /functional-tests in the rust group by @dependabot[bot] in #2105
• Revert "Merge pull request #1697 from onjen/fix-1142" by @felixfontein in #2099
• Release 3.12.2 by @felixfontein in #2109

New Contributors

• @CzBiX made their first contribution in #2100

Full Changelog: v3.12.1...v3.12.2

Contributors

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:

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:

Verify binary integrity

To verify the integrity of the downloaded binary, you can utilize the checksums file after having validated its signature:

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.12.1.intoto.jsonl. To verify the provenance of an artifact, you can utilize the slsa-verifier tool:

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.12.1
• ghcr.io/getsops/sops:v3.12.1-alpine

Quay.io

• quay.io/getsops/sops:v3.12.1
• quay.io/getsops/sops:v3.12.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:

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 .spdx.sbom.json.

What's Changed

• Release 3.12.1 by @felixfontein in #2080
• Many more changes, see CHANGELOG.md for 3.12.0.

Full Changelog: v3.11.0...v3.12.1

Contributors

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:

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:

Verify binary integrity

To verify the integrity of the downloaded binary, you can utilize the checksums file after having validated its signature:

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.11.0.intoto.jsonl. To verify the provenance of an artifact, you can utilize the slsa-verifier tool:

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.11.0
• ghcr.io/getsops/sops:v3.11.0-alpine

Quay.io

• quay.io/getsops/sops:v3.11.0
• quay.io/getsops/sops:v3.11.0-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:

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 .spdx.sbom.json.

What's Changed

• build(deps): Bump the go group with 4 updates by @dependabot[bot] in #1845
• build(deps): Bump the go group with 5 updates by @dependabot[bot] in #1850
• build(deps): Bump the ci group with 4 updates by @dependabot[bot] in #1849
• build(deps): Bump the go group with 8 updates by @dependabot[bot] in #1854
• build(deps): Bump tempfile from 3.19.1 to 3.20.0 in /functional-tests in the rust group by @dependabot[bot] in #1853
• build(deps): Bump actions/setup-go from 5.4.0 to 5.5.0 in the ci group by @dependabot[bot] in #1852
• use bullet points for structure by @md42 in #1844
• Introduce EncryptContext and DecryptContext for AWS, Azure, GCP, PGP and HashiCorp Vault by @matheuscscp in #1848
• build(deps): Bump the go group with 5 updates by @dependabot[bot] in #1856
• build(deps): Bump the ci group with 2 updates by @dependabot[bot] in #1857
• Allow injecting custom HTTP client for AWS, Azure, GCP and HashiCorp Vault by @matheuscscp in #1838
• Update authors in main.go by @jvehent in #1860
• build(deps): Bump the go group with 7 updates by @dependabot[bot] in #1861
• Remove unmatched '`' from README.rst by @wasv in #1863
• build(deps): Bump the go group with 4 updates by @dependabot[bot] in #1867
• build(deps): Bump alpine from 3.21 to 3.22 in /.release in the docker group by @dependabot[bot] in #1866
• build(deps): Bump the go group with 12 updates by @dependabot[bot] in #1870
• build(deps): Bump github/codeql-action from 3.28.18 to 3.28.19 in the ci group by @dependabot[bot] in #1869
• build(deps): Bump github.com/cloudflare/circl from 1.6.0 to 1.6.1 by @dependabot[bot] in #1871
• build(deps): Bump the go group with 12 updates by @dependabot[bot] in #1872
• build(deps): Bump the ci group across 1 directory with 3 updates by @dependabot[bot] in #1874
• build(deps): Bump the go group with 8 updates by @dependabot[bot] in #1878
• build(deps): Bump the ci group with 2 updates by @dependabot[bot] in #1879
• build(deps): Bump github.com/go-viper/mapstructure/v2 from 2.2.1 to 2.3.0 by @dependabot[bot] in #1882
• Fix Typo in README.rst by @inverted-tree in #1881
• build(deps): Bump the go group with 4 updates by @dependabot[bot] in #1884
• build(deps): Bump the ci group with 2 updates by @dependabot[bot] in #1883
• Correct Windows path to store keys.txt by @EshemMimi in #1885
• build(deps): Bump the go group with 3 updates by @dependabot[bot] in #1888
• build(deps): Bump the ci group with 2 updates by @dependabot[bot] in #1889
• build(deps): Bump the go group with 6 updates by @dependabot[bot] in #1893
• Add "--value-file" option to "sops set [...]" by @bjornfor in #1876
• Document XDG_CONFIG_HOME support on mac by @fredericrous in #1897
• Fix Shamir threshold encoding for INI and ENV files by @felixfontein in #1899
• build(deps): Bump the go group with 12 updates by @dependabot[bot] in #1908
• build(deps): Bump serde_json from 1.0.140 to 1.0.142 in /functional-tests in the rust group by @dependabot[bot] in #1907
• build(deps): Bump the ci group with 3 updates by @dependabot[bot] in #1905
• Fix docs: mention all stores instead of just YAML, JSON, and BINARY by @felixfontein in #1895
• Ensure temporary file for editing is only read-writable by owner by @felixfontein in #1903
• Add --value-stdin option to sops set by @felixfontein in #1894
• Collect age identity loading errors and only report if decryption failed by @felixfontein in #1898
• add completion script. Resolves #1868 by @longxiucai in #1892
• Resolves #1864. Adds Native List as an option for configuring keys. by @lucqui in #1880
• Fix example.yaml file by @felixfontein in #1909
• build(deps): Bump the go group with 15 updates by @dependabot[bot] in #1912
• build(deps): Bump the ci group with 4 updates by @dependabot[bot] in #1911
• build(deps): Bump the go group with 9 updates by @dependabot[bot] in #1917
• build(deps): Bump the ci group with 4 updates by @dependabot[bot] in #1916
• build(deps): Bump github.com/go-viper/mapstructure/v2 from 2.3.0 to 2.4.0 by @dependabot[bot] in #1920
• build(deps): Bump the go group with 14 updates by @dependabot[bot] in https://github.com/g...

Contributors

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:

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:

Verify binary integrity

To verify the integrity of the downloaded binary, you can utilize the checksums file after having validated its signature:

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.10.2.intoto.jsonl. To verify the provenance of an artifact, you can utilize the slsa-verifier tool:

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.10.2
• ghcr.io/getsops/sops:v3.10.2-alpine

Quay.io

• quay.io/getsops/sops:v3.10.2
• quay.io/getsops/sops:v3.10.2-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:

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 .spdx.sbom.json.

What's Changed

• build(deps): Bump the go group with 13 updates by @dependabot in #1834
• Use latest 1.24 Go version for release build by @hiddeco in #1836
• Remove reserved keyword check from YAML store's LoadPlainFile() by @felixfontein in #1829
• build(deps): Bump the go group with 9 updates by @dependabot in #1839
• build(deps): Bump github/codeql-action from 3.28.13 to 3.28.15 in the ci group by @dependabot in #1840
• Release 3.10.2 release by @felixfontein in #1841

Full Changelog: v3.10.1...v3.10.2

Contributors

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:

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:

Verify binary integrity

To verify the integrity of the downloaded binary, you can utilize the checksums file after having validated its signature:

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.10.1.intoto.jsonl. To verify the provenance of an artifact, you can utilize the slsa-verifier tool:

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.10.1
• ghcr.io/getsops/sops:v3.10.1-alpine

Quay.io

• quay.io/getsops/sops:v3.10.1
• quay.io/getsops/sops:v3.10.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:

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 .spdx.sbom.json.

What's Changed

• build(deps): Bump the ci group with 2 updates by @dependabot in #1826
• Release 3.10.1 by @felixfontein in #1827

Full Changelog: v3.10.0...v3.10.1

Contributors

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:

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:

Verify binary integrity

To verify the integrity of the downloaded binary, you can utilize the checksums file after having validated its signature:

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.10.0.intoto.jsonl. To verify the provenance of an artifact, you can utilize the slsa-verifier tool:

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.10.0
• ghcr.io/getsops/sops:v3.10.0-alpine

Quay.io

• quay.io/getsops/sops:v3.10.0
• quay.io/getsops/sops:v3.10.0-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:

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 .spdx.sbom.json.

What's Changed

• build(deps): Bump alpine from 3.18 to 3.21 in /.release in the docker group across 1 directory by @dependabot in #1700
• Convert changelog to MarkDown by @felixfontein in #1741
• build(deps): Bump the go group with 7 updates by @dependabot in #1743
• build(deps): Bump the go group with 9 updates by @dependabot in #1745
• build(deps): Bump the rust group in /functional-tests with 2 updates by @dependabot in #1744
• build(deps): Bump github/codeql-action from 3.28.5 to 3.28.8 in the ci group by @dependabot in #1746
• build(deps): Bump the go group with 12 updates by @dependabot in #1751
• build(deps): Bump the ci group with 4 updates by @dependabot in #1750
• Add --input-type option for filestatus subcommand by @felixfontein in #1601
• Use SOPS_EDITOR before EDITOR by @felixfontein in #1611
• Allow users to disable version check via environment variable by @nicklasfrahm in #1684
• add duplicate section support to ini store by @reindlt in #1452
• stores: test for duplicate keys, reserve keyword (yaml only now) by @holiman in #1203
• Add same process option for exec-env by @ricmatsui in #880
• outputs: add trailing newline at the end of JSON files by @duthils in #1476
• set subcommand: add --idempotent flag that will not write the file if no change happened by @felixfontein in #1754
• Encrypt and decrypt time.Time objects by @felixfontein in #1759
• build(deps): Bump the go group with 8 updates by @dependabot in #1763
• build(deps): Bump tempfile from 3.16.0 to 3.17.0 in /functional-tests in the rust group by @dependabot in #1762
• build(deps): Bump goreleaser/goreleaser-action from 6.1.0 to 6.2.1 in the ci group by @dependabot in #1761
• fix(docs): typo in README.rst by @paredev in #1765
• Add SSH support for age by @haoqixu in #1692
• make sure that tests do not pick keys.txt from user's HOME dir by @tomaszduda23 in #1766
• support for age identity with passphrase by @tomaszduda23 in #1400
• build(deps): Bump the rust group in /functional-tests with 4 updates by @dependabot in #1768
• build(deps): Bump the go group with 12 updates by @dependabot in #1769
• build(deps): Bump the ci group with 4 updates by @dependabot in #1770
• build(deps): Bump github.com/go-jose/go-jose/v4 from 4.0.4 to 4.0.5 by @dependabot in #1773
• feat: add age plugin support by @brianmcgee in #1641
• Check GnuPG decryption result for non-empty size by @felixfontein in #1776
• vendored age code: consolidate passphrase reading functionality by @felixfontein in #1775
• Allow to encrypt and decrypt from stdin by @felixfontein in #1690
• build(deps): Bump the go group with 11 updates by @dependabot in #1784
• build(deps): Bump the ci group with 5 updates by @dependabot in #1782
• build(deps): Bump serde_json from 1.0.139 to 1.0.140 in /functional-tests in the rust group; bump Rust to 1.85.0 by @dependabot in #1783
• build(deps): Bump the go group with 13 updates by @dependabot in #1797
• build(deps): Bump the rust group in /functional-tests with 3 updates by @dependabot in #1796
• build(deps): Bump github/codeql-action from 3.28.10 to 3.28.11 in the ci group by @dependabot in #1795
• build(deps): Bump the go group with 6 updates by @dependabot in #1802
• build(deps): Bump tempfile from 3.18.0 to 3.19.0 in /functional-tests in the rust group by @dependabot in #1800
• build(deps): Bump docker/login-action from 3.3.0 to 3.4.0 in the ci group by @dependabot in #1801
• build(deps): Bump github.com/golang-jwt/jwt/v5 from 5.2.1 to 5.2.2 by @dependabot in #1806
• goreleaser: add windows arm64 by @duthils in #1791
• Add a way to set sops config location via envvar by @sledzikowy in #1701
• build(deps): Bump the go group with 3 updates by @dependabot in #1809
• build(deps): Bump the ci group with 5 updates by @dependabot in #1808
• build(deps): Bump tempfile from 3.19.0 to 3.19.1 in /functional-tests in the rust group by @dependabot in #1807
• Support --config option in publish subcommand by @felixfontein in #1779
• Fix caching of Metadata.DataKey by @felixfontein in #1781
• Lint by @felixfontein in #1780
• updatekeys subcommand: rename...

Contributors

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:

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:

Verify binary integrity

To verify the integrity of the downloaded binary, you can utilize the checksums file after having validated its signature:

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.4.intoto.jsonl. To verify the provenance of an artifact, you can utilize the slsa-verifier tool:

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.4
• ghcr.io/getsops/sops:v3.9.4-alpine

Quay.io

• quay.io/getsops/sops:v3.9.4
• quay.io/getsops/sops:v3.9.4-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:

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 .spdx.sbom.json.

What's Changed

• build(deps): Bump the go group with 5 updates by @dependabot in #1727
• build(deps): Bump tempfile from 3.14.0 to 3.15.0 in /functional-tests in the rust group by @dependabot in #1728
• build(deps): Bump the go group with 16 updates by @dependabot in #1732
• build(deps): Bump the ci group with 3 updates by @dependabot in #1730
• build(deps): Bump serde_json from 1.0.134 to 1.0.135 in /functional-tests in the rust group by @dependabot in #1731
• build(deps): Bump the go group with 12 updates by @dependabot in #1734
• build(deps): Bump serde_json from 1.0.135 to 1.0.137 in /functional-tests in the rust group by @dependabot in #1735
• Fix ToString for AWS KMS to include role, context, and profile by @felixfontein in #1733
• build(deps): Bump the ci group with 3 updates by @dependabot in #1738
• build(deps): Bump the go group with 6 updates by @dependabot in #1739
• Release 3.9.4 by @felixfontein in #1740

Full Changelog: v3.9.3...v3.9.4

Contributors

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:

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:

Verify binary integrity

To verify the integrity of the downloaded binary, you can utilize the checksums file after having validated its signature:

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.3.intoto.jsonl. To verify the provenance of an artifact, you can utilize the slsa-verifier tool:

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.3
• ghcr.io/getsops/sops:v3.9.3-alpine

Quay.io

• quay.io/getsops/sops:v3.9.3
• quay.io/getsops/sops:v3.9.3-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:

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 .spdx.sbom.json.

What's Changed

• build(deps): Bump the go group with 10 updates by @dependabot in #1699
• build(deps): Bump the ci group with 2 updates by @dependabot in #1698
• build(deps): Bump golang.org/x/crypto from 0.30.0 to 0.31.0 by @dependabot in #1703
• build(deps): Bump the ci group with 4 updates by @dependabot in #1708
• build(deps): Bump the rust group in /functional-tests with 2 updates by @dependabot in #1707
• CI: add 'persist-credentials: false' to checkout actions by @felixfontein in #1704
• build(deps): Bump filippo.io/age from 1.2.0 to 1.2.1 by @dependabot in #1710
• Bump golang.org/x/net to 0.33.0 to address CVE-2024-45338 by @felixfontein in #1714
• build(deps): Bump the go group across 1 directory with 13 updates by @dependabot in #1715
• build(deps): Bump serde_json from 1.0.133 to 1.0.134 in /functional-tests in the rust group by @dependabot in #1716
• build(deps): Bump the ci group with 2 updates by @dependabot in #1717
• GnuPG: do not incorrectly trim fingerprint in presence of exclamation marks for specfic subkey selection by @felixfontein in #1720
• Tests: use container images from https://github.com/getsops/ci-container-images by @felixfontein in #1722
• updatekeys subcommand: fix input-type CLI flag being ignored by @felixfontein in #1721
• Update all Go dependencies by @felixfontein in #1723
• build(deps): Bump the rust group in /functional-tests with 2 updates by @dependabot in #1725
• Release 3.9.3 by @felixfontein in #1724

Full Changelog: v3.9.2...v3.9.3

Contributors

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:

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:

Verify binary integrity

To verify the integrity of the downloaded binary, you can utilize the checksums file after having validated its signature:

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.2.intoto.jsonl. To verify the provenance of an artifact, you can utilize the slsa-verifier tool:

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.2
• ghcr.io/getsops/sops:v3.9.2-alpine

Quay.io

• quay.io/getsops/sops:v3.9.2
• quay.io/getsops/sops:v3.9.2-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:

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 .spdx.sbom.json.

What's Changed

• build(deps): Bump the go group with 11 updates by @dependabot in #1645
• build(deps): Bump the ci group with 4 updates by @dependabot in #1644
• build(deps): Bump the go group with 12 updates by @dependabot in #1649
• build(deps): Bump the ci group with 5 updates by @dependabot in #1648
• build(deps): Bump the go group with 6 updates by @dependabot in #1653
• build(deps): Bump the ci group with 2 updates by @dependabot in #1654
• build(deps): Bump serde_json from 1.0.128 to 1.0.132 in /functional-tests in the rust group by @dependabot in #1655
• fix(azkv): handle whitespace in Azure Key Vault URLs by @sEpt0r in #1652
• build(deps): Bump the go group with 7 updates by @dependabot in #1662
• build(deps): Bump the ci group with 5 updates by @dependabot in #1664
• build(deps): Bump the rust group in /functional-tests with 2 updates by @dependabot in #1663
• build(deps): Bump the ci group across 1 directory with 3 updates by @dependabot in #1673
• build(deps): Bump the rust group in /functional-tests with 2 updates by @dependabot in #1670
• build(deps): Bump github/codeql-action from 3.27.1 to 3.27.4 in the ci group by @dependabot in #1677
• build(deps): Bump the rust group in /functional-tests with 3 updates by @dependabot in #1676
• build(deps): Bump the ci group with 2 updates by @dependabot in #1685
• build(deps): Bump the go group across 1 directory with 18 updates by @dependabot in #1686
• Correctly handle comments during JSON serialization by @felixfontein in #1647
• Update Rust dependencies by @felixfontein in #1689
• fix(config): remove unused variables and align error casing by @nicklasfrahm in #1687
• keyservice: update protobuf to a recent release, and make go code generation reproducible by @felixfontein in #1688
• build(deps): Bump the go group with 8 updates by @dependabot in #1693
• Release 3.9.2 by @felixfontein in #1691

New Contributors

• @sEpt0r made their first contribution in #1652
• @nicklasfrahm made their first contribution in #1687

Full Changelog: v3.9.1...v3.9.2

Contributors

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:

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:

Verify binary integrity

To verify the integrity of the downloaded binary, you can utilize the checksums file after having validated its signature:

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:

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:

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 .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 by loadConfig 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...

Contributors