engine: v28.1.0

Signed-off-by: Paweł Gronowski <pawel.gronowski@docker.com>

Author: vvoland

Diff for: content/manuals/engine/release-notes/28.md

@@ -13,6 +13,7 @@ aliases:
 - /release-notes/docker-ce/
 - /release-notes/docker-engine/
 - /engine/release-notes/28.0/
+- /engine/release-notes/28.1/
 ---
 
 This page describes the latest changes, additions, known issues, and fixes for Docker Engine version 28.
@@ -22,6 +23,74 @@ For more information about:
 - Deprecated and removed features, see [Deprecated Engine Features](../deprecated.md).
 - Changes to the Engine API, see [Engine API version history](/reference/api/engine/version-history.md).
 
+## 28.1.0
+
+{{< release-date date="2025-04-17" >}}
+
+For a full list of pull requests and changes in this release, refer to the relevant GitHub milestones:
+
+- [docker/cli, 28.1.0 milestone](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.1.0)
+- [moby/moby, 28.1.0 milestone](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.1.0)
+
+### New
+
+- Add `docker bake` subcommand as alias for `docker buildx bake`. [docker/cli#5947](https://github.com/docker/cli/pull/5947)
+- `docker image inspect` now supports a `--platform` flag to inspect a specific platform of a multi-platform image. [docker/cli#5934](https://github.com/docker/cli/pull/5934)
+
+### Bug fixes and enhancements
+
+- Adds a new flag `--use-api-socket` to enable access to docker from inside a container. [docker/cli#5858](https://github.com/docker/cli/pull/5858)
+- Fix `docker images --tree` not including non-container images content size in the total image content size. [docker/cli#6000](https://github.com/docker/cli/pull/6000)
+- Fix `docker load` not preserving replaced images. [moby/moby#49650](https://github.com/moby/moby/pull/49650)
+- Fix `docker stats` not working properly on machines with high CPU core count. [moby/moby#49734](https://github.com/moby/moby/pull/49734)
+- Fix a regression causing `docker pull/push` to fail when interacting with a private repository. [docker/cli#5964](https://github.com/docker/cli/pull/5964)
+- Fix an issue preventing rootless docker setup on a host with no `ip_tables` kernel module. [moby/moby#49727](https://github.com/moby/moby/pull/49727)
+- Fix an issue that could lead to unwanted iptables rules being restored and never deleted following a firewalld reload. [moby/moby#49728](https://github.com/moby/moby/pull/49728)
+- Improve CLI completion of `docker service scale`. [docker/cli#5968](https://github.com/docker/cli/pull/5968)
+- `docker images --tree`: hide both untagged and dangling images by default. [docker/cli#5924](https://github.com/docker/cli/pull/5924)
+- `docker system info` will provide an exit code if a connection cannot be established to the docker daemon. [docker/cli#5918](https://github.com/docker/cli/pull/5918)
+- containerd image store: Fix `image tag` event not being emitted when building with BuildKit. [moby/moby#49678](https://github.com/moby/moby/pull/49678)
+- containerd image store: Improve `docker push/pull` handling of the remote registry errors. [moby/moby#49770](https://github.com/moby/moby/pull/49770)
+- containerd image store: Show pull progress for non-layer image blobs. [moby/moby#49746](https://github.com/moby/moby/pull/49746)
+
+### Packaging updates
+
+- Add Debian "Trixie". [docker/docker-ce-packaging#1181](https://github.com/docker/docker-ce-packaging/pull/1181)
+- Add Fedora 42 packages. [docker/containerd-packaging#418](https://github.com/docker/containerd-packaging/pull/418), [docker/docker-ce-packaging#1169](https://github.com/docker/docker-ce-packaging/pull/1169)
+- Add Ubuntu "Plucky Puffin" packages. [docker/containerd-packaging#419](https://github.com/docker/containerd-packaging/pull/419), [docker/docker-ce-packaging#1177](https://github.com/docker/docker-ce-packaging/pull/1177)
+- Update BuildKit to [v0.21.0](https://github.com/moby/buildkit/releases/tag/v0.21.0). [moby/moby#49809](https://github.com/moby/moby/pull/49809)
+- Update Compose to [v2.35.0](https://github.com/docker/compose/releases/tag/v2.35.0). [docker/docker-ce-packaging#1183](https://github.com/docker/docker-ce-packaging/pull/1183)
+- Update Go runtime to [1.23.8](https://go.dev/doc/devel/release#go1.23.8). [docker/cli#5986](https://github.com/docker/cli/pull/5986), [docker/docker-ce-packaging#1180](https://github.com/docker/docker-ce-packaging/pull/1180), [moby/moby#49737](https://github.com/moby/moby/pull/49737)
+
+### Networking
+
+- Fix a bug causing host port-mappings on Swarm containers to be duplicated on `docker ps` and `docker inspect`. [moby/moby#49724](https://github.com/moby/moby/pull/49724)
+- Fix an issue that caused container network attachment to fail with error "Bridge port not forwarding". [moby/moby#49705](https://github.com/moby/moby/pull/49705)
+- Fix an issue with removal of a `--link` from a container in the default bridge network. [moby/moby#49778](https://github.com/moby/moby/pull/49778)
+- Improve how network-endpoint relationships are tracked to reduce the chance of the "has active endpoints" error to be wrongfully returned. [moby/moby#49736](https://github.com/moby/moby/pull/49736)
+- Improve the "has active endpoints" error message by including the name of endpoints still connected to the network being deleted. [moby/moby#49773](https://github.com/moby/moby/pull/49773)
+
+### API
+
+- Update API version to [v1.49](https://docs.docker.com/engine/api/v1.49/). [moby/moby#49718](https://github.com/moby/moby/pull/49718)
+- `GET /image/{name}/json` now supports `platform` parameter allowing to specify which platform variant of a multi-platform image to inspect. [moby/moby#49586](https://github.com/moby/moby/pull/49586)
+- `GET /info` now returns a `FirewallBackend` containing information about the daemon's firewalling configuration. [moby/moby#49761](https://github.com/moby/moby/pull/49761)
+
+### Go SDK
+
+- cli/command/context: remove temporary `ContextType` field from JSON output. [docker/cli#5981](https://github.com/docker/cli/pull/5981)
+- client: Keep image references in canonical format where possible. [moby/moby#49609](https://github.com/moby/moby/pull/49609)
+
+### Deprecations
+
+- API: Deprecated `AllowNondistributableArtifactsCIDRs` and `AllowNondistributableArtifactsHostnames` fields in the `RegistryConfig` struct in the `GET /info` response are omitted in API v1.49. [moby/moby#49749](https://github.com/moby/moby/pull/49749)
+- API: Deprecated: The `ContainerdCommit.Expected`, `RuncCommit.Expected`, and `InitCommit.Expected` fields in the `GET /info` endpoint were deprecated in API v1.48, and are now omitted in API v1.49. [moby/moby#48556](https://github.com/moby/moby/pull/48556)
+- Go-SDK: cli/command/image: Deprecate `RunPull`: this function was only used internally and will be removed in the next release. [docker/cli#5975](https://github.com/docker/cli/pull/5975)
+- Go-SDK: cli/config/configfile: deprecate `ConfigFile.Experimental` field. Experimental CLI features are always enabled since version v20.10 and this field is no longer used. Use `ConfigFile.Features` instead for optional features. This field will be removed in a future release. [docker/cli#5977](https://github.com/docker/cli/pull/5977)
+- Go-SDK: deprecate `pkg/atomicwriter`, which was migrated to `github.com/moby/sys/atomicwriter`. [moby/moby#49748](https://github.com/moby/moby/pull/49748)
+- Go-SDK: opts: remove deprecated `PortOpt`, `ConfigOpt`, `SecretOpt` aliases. [docker/cli#5953](https://github.com/docker/cli/pull/5953)
+- Go-SDK: registry: deprecate `APIEndpoint.Official` field. [moby/moby#49706](https://github.com/moby/moby/pull/49706)
+
 ## 28.0.4
 
 {{< release-date date="2025-03-25" >}}

Diff for: content/reference/api/engine/version/v1.48.md

@@ -3,6 +3,4 @@ linkTitle: v1.48
 title: Docker Engine API v1.48 reference
 aliases:
   - /engine/api/v1.48/
-  - /engine/api/latest/
-  - /reference/api/engine/latest/
 ---

Diff for: content/reference/api/engine/version/v1.49.md

@@ -0,0 +1,8 @@
+---
+linkTitle: v1.49
+title: Docker Engine API v1.49 reference
+aliases:
+  - /engine/api/v1.49/
+  - /engine/api/latest/
+  - /reference/api/engine/latest/
+---

Diff for: hugo.yaml

@@ -132,16 +132,16 @@ params:
   # Use `grep` to figure out how they might be used.
 
   # Latest version of the Docker Engine API
-  latest_engine_api_version: "1.48"
+  latest_engine_api_version: "1.49"
   # Latest version of Docker Engine
-  docker_ce_version: "28.0.4"
+  docker_ce_version: "28.1.0"
   # Previous version of the Docker Engine
   # (Used to show e.g., "latest" and "latest"-1 in engine install examples
-  docker_ce_version_prev: "28.0.3"
+  docker_ce_version_prev: "28.0.4"
   # Latest Docker Compose version
   compose_version: "v2.35.0"
   # Latest BuildKit version
-  buildkit_version: "0.20.2"
+  buildkit_version: "0.21.0"
 
   # Example runtime/library/os versions
   example_go_version: "1.23"