●Change8

Migrating to Docker Registry v3.1.0

Version v3.1.0 introduces 1 breaking change. This guide details how to update your code.

Released: 4/6/2026

1
Breaking Changes
1
Migration Steps
9
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

Azure storage providertag endpointredis config structUUID generationS3 driverOTEL traces configurationecdsa key thumbprint calculationmanifest HEAD requests handlernotification filtering logic

Breaking Changes

●Issue #1

Support for go1.23 and go1.24 has been dropped; users must now use go1.25 or newer.

Migration Steps

  1. 1
    Ensure your build environment uses Go 1.25 or newer, as support for go1.23 and go1.24 has been removed.

Release Summary

This stable release introduces tag pagination support and addresses critical security vulnerabilities (CVE-2026-35172, CVE-2026-33540). It also mandates upgrading the minimum required Go version to 1.25.

Need More Details?

View the full release notes and all changes for Docker Registry v3.1.0.

View Full Changelog