Troubleshoot Docker Offload

{{< summary-bar feature_name="Docker Offload" >}}

Docker Offload requires:

• Authentication
• An active internet connection
• No restrictive proxy or firewall blocking traffic to Docker Cloud
• Access to Docker Offload
• Docker Desktop 4.68 or later

Docker Desktop uses Offload to run both builds and containers in the cloud. If builds or containers are failing to run, falling back to local, or reporting session errors, use the following steps to help resolve the issue.

1. Ensure Docker Offload is enabled in Docker Desktop:

   1. Open Docker Desktop and sign in.
   2. Go to Settings > Docker Offload.
   3. Ensure that Enable Docker Offload is toggled on.

2. Use the following command to check if the connection is active:

   $ docker offload status
   

3. To get more information, run the following command:

   $ docker offload diagnose
   

4. If you're not connected, start a new session:

   $ docker offload start
   

5. Verify authentication with docker login.

6. If needed, you can sign out and then sign in again:

   $ docker logout
   $ docker login
   

7. Verify your usage. For more information, see Docker Offload usage.