Files
docker-docs/content/manuals/offload/troubleshoot.md
Craig Osterhout e9ad5f424e offload: enterprise ea (#23632)
<!--Delete sections as needed -->

## Description

Updated Offload Beta docs for enterprise EA.

Notable topics updated:

- [All topics under
`/offload/`](https://deploy-preview-23632--docsdocker.netlify.app/offload/)
- [Manage Docker
products](https://deploy-preview-23632--docsdocker.netlify.app/admin/organization/manage-products/)
- [Settings reference - Enable Docker
Offload](https://deploy-preview-23632--docsdocker.netlify.app/enterprise/security/hardened-desktop/settings-management/settings-reference/#enable-docker-offload)
- [Settings - Docker
Offload](https://deploy-preview-23632--docsdocker.netlify.app/desktop/settings-and-maintenance/settings/#docker-offload)
- [VM/VDI - Use Docker
Offload](https://deploy-preview-23632--docsdocker.netlify.app/desktop/setup/vm-vdi/#use-docker-offload)
- [Docker Offload CLI
reference](https://deploy-preview-23632--docsdocker.netlify.app/reference/cli/docker/offload/)

~~**Pending audit log updates**~~ Will handle in followup PR to keep
this moving

## Related issues or tickets

DCL-745
DCL-1033
DCL-1019
ENGDOCS-2929

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2025-11-06 23:54:16 -08:00

1.4 KiB

title, linktitle, weight, description, keywords, tags
title linktitle weight description keywords tags
Troubleshoot Docker Offload Troubleshoot 800 Learn how to troubleshoot issues with Docker Offload. cloud, troubleshooting, cloud mode, Docker Desktop, cloud builder, usage
Troubleshooting

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.50 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 and billing. For more information, see Docker Offload usage.