Sops

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.13.0/sops-v3.13.0.linux.amd64

# Move the binary in to your PATH
mv sops-v3.13.0.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.13.0/sops-v3.13.0.checksums.txt
curl -LO https://github.com/getsops/sops/releases/download/v3.13.0/sops-v3.13.0.checksums.sigstore.json

# Verify the checksums file
cosign verify-blob sops-v3.13.0.checksums.txt \
  --bundle sops-v3.13.0.checksums.sigstore.json \
  --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.13.0.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.13.0.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.13.0/sops-v3.13.0.intoto.jsonl

# Verify the provenance of the artifact
slsa-verifier verify-artifact <artifact> \
  --provenance-path sops-v3.13.0.intoto.jsonl \
  --source-uri github.com/getsops/sops \
  --source-tag v3.13.0

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

Quay.io

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

cosign verify ghcr.io/getsops/sops:v3.13.0 \
  --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

• build(deps): Bump google.golang.org/grpc from 1.79.1 to 1.79.3 by @dependabot[bot] in https://github.com/getsops/sops/pull/2110
• build(deps): Bump the ci group with 3 updates by @dependabot[bot] in https://github.com/getsops/sops/pull/2117
• build(deps): Bump the ci group with 3 updates by @dependabot[bot] in https://github.com/getsops/sops/pull/2126
• build(deps): Bump github.com/go-jose/go-jose/v4 from 4.1.3 to 4.1.4 by @dependabot[bot] in https://github.com/getsops/sops/pull/2133
• build(deps): Bump docker/login-action from 4.0.0 to 4.1.0 in the ci group by @dependabot[bot] in https://github.com/getsops/sops/pull/2139
• Improve error message for top-level arrays by @kushal9897 in https://github.com/getsops/sops/pull/2138
• build(deps): Bump github.com/aws/aws-sdk-go-v2/service/s3 from 1.96.0 to 1.97.3 by @dependabot[bot] in https://github.com/getsops/sops/pull/2142
• docs: add get key permission requirement for Azure Key Vault when version is omitted by @Hanashiko in https://github.com/getsops/sops/pull/2122
• build(deps): Bump actions/upload-artifact from 7.0.0 to 7.0.1 in the ci group by @dependabot[bot] in https://github.com/getsops/sops/pull/2149
• Use prefixed and truncated key hash instead of location as GPG agent cache key by @felixfontein in https://github.com/getsops/sops/pull/2145
• Drop support for Go 1.24 by @felixfontein in https://github.com/getsops/sops/pull/2141
• build(deps): Bump go.opentelemetry.io/otel/sdk from 1.40.0 to 1.43.0 by @dependabot[bot] in https://github.com/getsops/sops/pull/2146
• build(deps): Bump the go group across 1 directory with 21 updates by @dependabot[bot] in https://github.com/getsops/sops/pull/2144
• Add SOPS_GCP_KMS_ENDPOINT and SOPS_GCP_KMS_UNIVERSE_DOMAIN env vars by @DnR-iData in https://github.com/getsops/sops/pull/2114
• Preserve YAML inline comments through encrypt/edit roundtrip by @knowald in https://github.com/getsops/sops/pull/2131
• Update release for cosign v3 by @sabre1041 in https://github.com/getsops/sops/pull/2082
• build(deps): Bump the ci group with 3 updates by @dependabot[bot] in https://github.com/getsops/sops/pull/2151
• build(deps): Bump the go group with 12 updates by @dependabot[bot] in https://github.com/getsops/sops/pull/2152
• Update broken link in README by @manute in https://github.com/getsops/sops/pull/2153
• sops exec-file: make sure to set GID to correct value instead of UID by @felixfontein in https://github.com/getsops/sops/pull/2154
• sops exec-file: improve error handling, reject non-local paths in --filename by @felixfontein in https://github.com/getsops/sops/pull/2155
• Obtain --indent global flag value and pass it to store configs by @skirino in https://github.com/getsops/sops/pull/2156
• build(deps): Bump the go group with 3 updates by @dependabot[bot] in https://github.com/getsops/sops/pull/2159
• build(deps): Bump goreleaser/goreleaser-action from 7.1.0 to 7.2.1 in the ci group by @dependabot[bot] in https://github.com/getsops/sops/pull/2158
• Update all Go dependencies with 'go get -t -u ./...' by @felixfontein in https://github.com/getsops/sops/pull/2165
• Allow to have space-separated keys in SOPS_AGE_KEY by @felixfontein in https://github.com/getsops/sops/pull/2086
• HC Vault: add allowlist support for acceptable HC Vault URLs by @felixfontein in https://github.com/getsops/sops/pull/2164
• build(deps): Bump the go group with 5 updates by @dependabot[bot] in https://github.com/getsops/sops/pull/2171
• build(deps): Bump github/codeql-action from 4.35.2 to 4.35.3 in the ci group by @dependabot[bot] in https://github.com/getsops/sops/pull/2173
• Use mapstructure to (de-)serialize internal metadata; move metadata processing from specific stores to general place by @felixfontein in https://github.com/getsops/sops/pull/2120
• Release 3.13.0 by @felixfontein in https://github.com/getsops/sops/pull/2176

New Contributors

• @kushal9897 made their first contribution in https://github.com/getsops/sops/pull/2138
• @Hanashiko made their first contribution in https://github.com/getsops/sops/pull/2122
• @DnR-iData made their first contribution in https://github.com/getsops/sops/pull/2114
• @knowald made their first contribution in https://github.com/getsops/sops/pull/2131
• @manute made their first contribution in https://github.com/getsops/sops/pull/2153
• @skirino made their first contribution in https://github.com/getsops/sops/pull/2156

Full Changelog: https://github.com/getsops/sops/compare/v3.12.2...v3.13.0

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.12.2/sops-v3.12.2.linux.amd64

# Move the binary in to your PATH
mv sops-v3.12.2.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.12.2/sops-v3.12.2.checksums.txt
curl -LO https://github.com/getsops/sops/releases/download/v3.12.2/sops-v3.12.2.checksums.pem
curl -LO https://github.com/getsops/sops/releases/download/v3.12.2/sops-v3.12.2.checksums.sig

# Verify the checksums file
cosign verify-blob sops-v3.12.2.checksums.txt \
  --certificate sops-v3.12.2.checksums.pem \
  --signature sops-v3.12.2.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.12.2.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.12.2.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.12.2/sops-v3.12.2.intoto.jsonl

# Verify the provenance of the artifact
slsa-verifier verify-artifact <artifact> \
  --provenance-path sops-v3.12.2.intoto.jsonl \
  --source-uri github.com/getsops/sops \
  --source-tag v3.12.2

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:

cosign verify ghcr.io/getsops/sops:v3.12.2 \
  --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

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

New Contributors

• @CzBiX made their first contribution in https://github.com/getsops/sops/pull/2100

Full Changelog: https://github.com/getsops/sops/compare/v3.12.1...v3.12.2

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.12.1/sops-v3.12.1.linux.amd64

# Move the binary in to your PATH
mv sops-v3.12.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.12.1/sops-v3.12.1.checksums.txt
curl -LO https://github.com/getsops/sops/releases/download/v3.12.1/sops-v3.12.1.checksums.pem
curl -LO https://github.com/getsops/sops/releases/download/v3.12.1/sops-v3.12.1.checksums.sig

# Verify the checksums file
cosign verify-blob sops-v3.12.1.checksums.txt \
  --certificate sops-v3.12.1.checksums.pem \
  --signature sops-v3.12.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.12.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.12.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.12.1/sops-v3.12.1.intoto.jsonl

# Verify the provenance of the artifact
slsa-verifier verify-artifact <artifact> \
  --provenance-path sops-v3.12.1.intoto.jsonl \
  --source-uri github.com/getsops/sops \
  --source-tag v3.12.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.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:

cosign verify ghcr.io/getsops/sops:v3.12.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

• Release 3.12.1 by @felixfontein in https://github.com/getsops/sops/pull/2080
• Many more changes, see CHANGELOG.md for 3.12.0.

Full Changelog: https://github.com/getsops/sops/compare/v3.11.0...v3.12.1