Docker Engine Documentation

Oct 13, 2025 by pynkocean.com 51 views

Ubuntu: Breaking Change - Docker Engine Version 26. to be Updated to 28. from 2025-05-09**

As part of our ongoing efforts to provide the latest and greatest technologies to our users, we are announcing a breaking change in the Docker Engine version used in Ubuntu OS. Starting from 2025-05-09, Docker Engine Version 26.* will be updated to Docker Engine Version 28.*. This change will bring numerous benefits, including improved security, performance, and feature enhancements. However, it also means that projects depending on the older version might be broken.

Docker Engine Version 26.* will be removed from Ubuntu OS, and Docker Engine Version 28.* will be added. This change is necessary to ensure that our users have access to the latest and most secure version of Docker Engine. The removal of the older version will also help to reduce the risk of security vulnerabilities and improve the overall stability of our system.

The image deployment for this change will start on 2025-05-05 and is expected to take 2-3 days to complete. During this time, you may experience some disruptions to your services. We recommend that you plan accordingly and take necessary steps to minimize any potential impact.

The motivation behind this change is to update the Docker Engine to the latest version, which is 28.*. This will enable our users to take advantage of the latest features, improvements, and security patches. By doing so, we can ensure that our users have access to the most secure and reliable version of Docker Engine.

If your projects depend on Docker Engine version 26.*, they might be broken after the update. This is because the older version will be removed, and the new version will have different dependencies and configurations. We recommend that you review your projects and update them to use the latest version of Docker Engine.

The following platforms will be affected by this change:

Azure DevOps: Yes
GitHub Actions: Yes

The following runner images will be affected by this change:

Ubuntu 20.04: Yes
Ubuntu 22.04: Yes
Ubuntu 24.04: Yes
macOS 13: No
macOS 13 Arm64: No
macOS 14: No
macOS 14 Arm64: No
macOS 15: No
macOS 15 Arm64: No
Windows Server 2019: No
Windows Server 2022: No
Windows Server 2025: No

To mitigate the impact of this change, we recommend that you:

Review your projects and update them to use the latest version of Docker Engine.
Test your projects thoroughly to ensure that they work as expected with the new version.
Plan for the image deployment and take necessary steps to minimize any potential impact.

In conclusion, the update of Docker Engine from version 26.* to 28.* will bring numerous benefits, including improved security, performance, and feature enhancements. However, it also means that projects depending on the older version might be broken. We recommend that you review your projects and update them to use the latest version of Docker Engine to minimize any potential impact. If you have any questions or concerns, please do not hesitate to reach out to us.

Q: What is the target date for the image deployment? A: The image deployment will start on 2025-05-05 and is expected to take 2-3 days to complete.
Q: What is the motivation behind this change? A: The motivation behind this change is to update the Docker Engine to the latest version, which is 28.*.
Q: What are the possible impacts of this change? A: If your projects depend on Docker Engine version 26.*, they might be broken after the update.
Q: Which platforms are affected by this change? A: The following platforms will be affected by this change: Azure DevOps, GitHub Actions.
Q: Which runner images are affected by this change? A: The following runner images will be affected by this change: Ubuntu 20.04, Ubuntu 22.04, Ubuntu 24.04.
Ubuntu: Breaking Change - Docker Engine Version 26. to be Updated to 28. from 2025-05-09 - Q&A**

Q: What is the target date for the image deployment? A: The image deployment will start on 2025-05-05 and is expected to take 2-3 days to complete.

Q: What is the motivation behind this change? A: The motivation behind this change is to update the Docker Engine to the latest version, which is 28.*. This will enable our users to take advantage of the latest features, improvements, and security patches.

Q: What are the possible impacts of this change? A: If your projects depend on Docker Engine version 26.*, they might be broken after the update. This is because the older version will be removed, and the new version will have different dependencies and configurations.

Q: Which platforms are affected by this change? A: The following platforms will be affected by this change: Azure DevOps, GitHub Actions.

Q: Which runner images are affected by this change? A: The following runner images will be affected by this change: Ubuntu 20.04, Ubuntu 22.04, Ubuntu 24.04.

Q: Will my projects be affected if I use a different version of Docker Engine? A: No, if you are using a different version of Docker Engine, your projects will not be affected by this change.

Q: How can I update my projects to use the latest version of Docker Engine? A: You can update your projects to use the latest version of Docker Engine by following these steps:

Review your project's dependencies and update them to use the latest version of Docker Engine.
Test your project thoroughly to ensure that it works as expected with the new version.
Update your project's configuration files to use the latest version of Docker Engine.

Q: What if I encounter issues after updating my projects to use the latest version of Docker Engine? A: If you encounter issues after updating your projects to use the latest version of Docker Engine, you can contact our support team for assistance. We will do our best to help you resolve the issue as quickly as possible.

Q: Will there be any downtime during the image deployment? A: Yes, there may be some downtime during the image deployment. We recommend that you plan accordingly and take necessary steps to minimize any potential impact.

Q: Can I revert to the older version of Docker Engine if I encounter issues? A: No, once the older version of Docker Engine is removed, you will not be able to revert to it. You will need to update your projects to use the latest version of Docker Engine.

Docker Engine Documentation: For more information on Docker Engine, please refer to the official documentation.
Ubuntu Support: For assistance with updating your projects to use the latest version of Docker Engine, please contact our support team.
Community Forum: For discussion and feedback on the update, please visit our community forum.