Skip to content

Commit e9ad5f4

Browse files
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>
1 parent cfb5e4c commit e9ad5f4

File tree

21 files changed

+277
-295
lines changed

21 files changed

+277
-295
lines changed

content/manuals/admin/organization/manage-products.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@ product, including how to set up and configure them, see the following manuals:
1616
- [Docker Build Cloud](../../build-cloud/_index.md)
1717
- [Docker Scout](../../scout/_index.md)
1818
- [Testcontainers Cloud](https://testcontainers.com/cloud/docs/#getting-started)
19+
- [Docker Offload](../../offload/_index.md)
1920

2021
## Manage product access for your organization
2122

@@ -98,6 +99,39 @@ To manage access to Testcontainers Cloud:
9899
select **Account**.
99100
1. Select **Settings**, then **Lock access to Testcontainers Cloud**.
100101

102+
{{< /tab >}}
103+
{{< tab name="Docker Offload" >}}
104+
105+
### Manage Docker Offload access
106+
107+
> [!NOTE]
108+
>
109+
> Docker Offload isn't included in the core Docker subscription plans. To make Docker Offload available, you must [sign
110+
> up](https://www.docker.com/products/docker-offload/) and subscribe.
111+
112+
To manage Docker Offload access for your organization, use [Settings
113+
Management](/manuals/enterprise/security/hardened-desktop/settings-management/_index.md):
114+
115+
1. Sign in to [Docker Home](https://app.docker.com/) as an organization owner.
116+
1. Select **Admin Console** > **Desktop Settings Management**.
117+
1. Configure the **Enable Docker Offload** setting to control whether Docker Offload features are available in Docker
118+
Desktop. You can configure this setting in five states:
119+
- **Always enabled**: Docker Offload is always enabled and users cannot disable it. The Offload
120+
toggle is always visible in Docker Desktop header. Recommended for VDI environments where local Docker execution is
121+
not possible.
122+
- **Enabled**: Docker Offload is enabled by default but users can disable it in Docker Desktop
123+
settings. Suitable for hybrid environments.
124+
- **Disabled**: Docker Offload is disabled by default but users can enable it in Docker Desktop
125+
settings.
126+
- **Always disabled**: Docker Offload is disabled and users cannot enable it. The option is
127+
visible but locked. Use when Docker Offload is not approved for organizational use.
128+
- **User defined**: No enforced default. Users choose whether to enable or disable Docker Offload in their
129+
Docker Desktop settings.
130+
1. Select **Save**.
131+
132+
For more details on Settings Management, see the [Settings
133+
reference](/manuals/enterprise/security/hardened-desktop/settings-management/settings-reference.md#enable-docker-offload).
134+
101135
{{< /tab >}}
102136
{{< /tabs >}}
103137

@@ -110,6 +144,8 @@ To view usage for Docker products:
110144
- Docker Build Cloud: View the **Build minutes** page in [Docker Build Cloud](http://app.docker.com/build).
111145
- Docker Scout: View the [**Repository settings** page](https://scout.docker.com/settings/repos) in Docker Scout.
112146
- Testcontainers Cloud: View the [**Billing** page](https://app.testcontainers.cloud/dashboard/billing) in Testcontainers Cloud.
147+
- Docker Offload: View the **Offload** > **Offload overview** page in [Docker Home](https://app.docker.com/). For more details, see
148+
[Docker Offload usage and billing](/offload/usage/).
113149

114150
If your usage or seat count exceeds your subscription amount, you can
115151
[scale your subscription](../../subscription/scale.md) to meet your needs.

content/manuals/desktop/settings-and-maintenance/settings.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -519,3 +519,15 @@ On Mac, you can reconfigure your initial installation settings on the **Advance
519519
- **Allow privileged port mapping (Requires password)**. Starts the privileged helper process which binds the ports that are between 1 and 1024. For more information, see [permission requirements for macOS](/manuals/desktop/setup/install/mac-permission-requirements.md#binding-privileged-ports).
520520

521521
For more information on each configuration and use case, see [Permission requirements](/manuals/desktop/setup/install/mac-permission-requirements.md).
522+
523+
## Docker Offload
524+
525+
When signed in with a Docker account that has access to [Docker Offload](../../offload/_index.md), you can manage your
526+
Offload settings from the **Docker Offload** tab.
527+
528+
Use the **Docker Offload** tab to:
529+
530+
- Toggle **Enable Docker Offload**. When enabled, you can start Offload sessions.
531+
- Select **Idle timeout**. This is the duration of time between no activity and Docker Offload entering idle mode.For
532+
details about idle timeout, see [Active and idle states](../../offload/configuration.md#understand-active-and-idle-states)
533+
- Check **Enable GPU support**. When enabled, workloads can use cloud GPU if available.

content/manuals/desktop/setup/vm-vdi.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -16,18 +16,16 @@ depending on whether nested virtualization is supported:
1616

1717
- If your environment supports nested virtualization, you can run Docker Desktop
1818
with its default local Linux VM.
19-
- If nested virtualization is not supported, Docker recommends using [Docker
20-
Offload](/offload/).
19+
- If nested virtualization is not supported, Docker recommends subscribing to and using Docker Offload.
2120

2221
## Use Docker Offload
2322

24-
Docker Offload lets you offload container workloads to a high-performance, fully
25-
hosted cloud environment, enabling a seamless hybrid experience.
23+
[Docker Offload](/offload/) lets you offload container workloads to a high-performance, fully hosted cloud environment,
24+
enabling a seamless hybrid experience.
2625

27-
Docker Offload is useful in virtual desktop environments where nested
28-
virtualization isn't supported. In these environments, Docker Desktop defaults
29-
to using Docker Offload to ensure you can still build and run containers without
30-
relying on local virtualization.
26+
Docker Offload is useful in virtual desktop environments where nested virtualization isn't supported. In these
27+
environments, Docker Desktop can use Docker Offload to ensure you can still build and run containers without relying on
28+
local virtualization.
3129

3230
Docker Offload decouples the Docker Desktop client from the Docker Engine,
3331
allowing the Docker CLI and Docker Desktop Dashboard to interact with

content/manuals/enterprise/security/hardened-desktop/settings-management/settings-reference.md

Lines changed: 9 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -906,13 +906,18 @@ deployment of AI features in security-conscious organizations.
906906
|---------------|-----------------|----------|
907907
| `false` | `true`, `false` | Boolean |
908908

909-
- **Description:** Enable [Docker Offload](/offload/) in Docker Desktop.
909+
- **Description:** Enable Docker Offload integration features and functionality. When enabled, users see the Docker Offload toggle in the Docker Desktop header.
910910
- **OS:** {{< badge color=blue text="All" >}}
911-
- **Use case:** Offload building and running containers to the cloud.
911+
- **Use case:** Control Docker Offload availability and whether users can change the setting.
912912
- **Configure this setting with:**
913-
- **Beta** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
913+
- **Docker Offload** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
914914
- Settings Management: `enableCloud` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
915-
- Settings Management: **Enable Docker Cloud** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
915+
- Settings Management: **Enable Docker Offload** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
916+
917+
> [!NOTE]
918+
>
919+
> This setting is only available when Docker Offload capability is enabled for
920+
> the organization.
916921
917922
### Enable Wasm
918923

@@ -1046,17 +1051,6 @@ you relax this in a controlled way. See ECI Configuration for more info.
10461051

10471052
The following settings aren’t shown in the Docker Desktop GUI. You can only configure them using Settings Management with the Admin Console or the `admin-settings.json` file.
10481053

1049-
### Enable Docker Cloud GPU Support
1050-
1051-
| Default value | Accepted values | Format |
1052-
|---------------|-----------------|----------|
1053-
| `true` | `true`, `false` | Boolean |
1054-
1055-
- **Description:** Enable GPU support for Docker Cloud features.
1056-
- **OS:** {{< badge color=blue text="All" >}}
1057-
- **Configure this setting with:**
1058-
- Settings Management: **Enable Docker Cloud GPU Support** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md
1059-
10601054
### Block `docker load`
10611055

10621056
| Default value | Accepted values | Format |

content/manuals/offload/_index.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,8 @@ params:
77
sidebar:
88
group: Products
99
badge:
10-
color: blue
11-
text: Beta
10+
color: violet
11+
text: Early Access
1212

1313
grid:
1414

@@ -27,13 +27,13 @@ grid:
2727
icon: tune
2828
link: /offload/configuration/
2929

30-
- title: Usage
31-
description: Learn about Docker Offload usage and how to monitor your cloud resources.
30+
- title: Usage and billing
31+
description: Learn about Docker Offload usage and billing, and how to monitor your cloud resources.
3232
icon: monitor_heart
3333
link: /offload/usage/
3434

3535
- title: Optimize
36-
description: Improve performance, caching, and cost efficiency in Docker Offload.
36+
description: Improve performance and cost efficiency in Docker Offload.
3737
icon: speed
3838
link: /offload/optimize/
3939

@@ -55,8 +55,8 @@ aliases:
5555

5656
Docker Offload is a fully managed service that lets you offload building and
5757
running containers to the cloud using the Docker tools you already know. It
58-
provides cloud infrastructure for fast, consistent builds and compute-heavy
59-
workloads like running LLMs or machine learning pipelines.
58+
enables developers to work efficiently in virtual desktop infrastructure (VDI)
59+
environments or systems that don't support nested virtualization.
6060

6161
In the following topics, learn about Docker Offload, how to set it up, use it
6262
for your workflows, and troubleshoot common issues.

content/manuals/offload/about.md

Lines changed: 13 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -3,39 +3,32 @@ title: About Docker Offload
33
linktitle: About
44
weight: 15
55
description: Learn about Docker Offload, its features, and how it works.
6-
keywords: cloud, build, remote builder
6+
keywords: cloud, offload, vdi
77
---
88

99
Docker Offload is a fully managed service for building and running containers in
1010
the cloud using the Docker tools you already know, including Docker Desktop, the
1111
Docker CLI, and Docker Compose. It extends your local development workflow into a
12-
scalable, cloud-powered environment, so you can offload compute-heavy tasks,
13-
accelerate builds, and securely manage container workloads across the software
14-
lifecycle.
12+
scalable, cloud-powered environment, enabling developers to work efficiently even
13+
in virtual desktop infrastructure (VDI) environments or systems that don't support
14+
nested virtualization.
15+
1516

16-
Docker Offload also supports GPU-accelerated instances, allowing you to
17-
containerize and run compute-intensive workloads such as Docker Model Runner and
18-
other machine learning or data processing tasks that benefit from GPU.
1917

2018
## Key features
2119

2220
Docker Offload includes the following capabilities to support modern container
2321
workflows:
2422

25-
- Cloud-based builds: Execute builds on remote, fully managed BuildKit instances
26-
- GPU acceleration: Use NVIDIA L4 GPU-backed environments for machine learning,
27-
media processing, and other compute-intensive workloads.
2823
- Ephemeral cloud runners: Automatically provision and tear down cloud
2924
environments for each container session.
30-
- Shared build cache: Speed up build times across machines and teammates with a
31-
smart, shared cache layer.
3225
- Hybrid workflows: Seamlessly transition between local and remote execution
3326
using Docker Desktop or CLI.
3427
- Secure communication: Use encrypted tunnels between Docker Desktop and cloud
3528
environments with support for secure secrets and image pulling.
3629
- Port forwarding and bind mounts: Retain a local development experience even
3730
when running containers in the cloud.
38-
- VDI-friendly: Use Docker Offload in virtual desktop environments or systems that
31+
- VDI-friendly: [Use Docker Desktop](../desktop/setup/vm-vdi.md) in virtual desktop environments or systems that
3932
don't support nested virtualization.
4033

4134
## Why use Docker Offload?
@@ -44,9 +37,7 @@ Docker Offload is designed to support modern development teams working across
4437
local and cloud environments. It helps you:
4538

4639
- Offload heavy builds and runs to fast, scalable infrastructure
47-
- Accelerate feedback loops in development and testing
4840
- Run containers that require more resources than your local setup can provide
49-
- Build and run AI apps with instant access to GPU-powered environments
5041
- Use Docker Compose to manage complex, multi-service apps that need cloud
5142
resources
5243
- Maintain consistent environments without managing custom infrastructure
@@ -61,39 +52,16 @@ local tools.
6152
Docker Offload replaces the need to build or run containers locally by connecting
6253
Docker Desktop to secure, dedicated cloud resources.
6354

64-
### Building with Docker Offload
65-
66-
When you use Docker Offload for builds, the `docker buildx build` command sends
67-
the build request to a remote BuildKit instance in the cloud, instead of
68-
executing it locally. Your workflow stays the same, only the execution
69-
environment changes.
70-
71-
The build runs on infrastructure provisioned and managed by Docker:
72-
73-
- Each cloud builder is an isolated Amazon EC2 instance with its own EBS volume
74-
- Remote builders use a shared cache to speed up builds across machines and
75-
teammates
76-
- Build results are encrypted in transit and sent to your specified destination
77-
(such as a registry or local image store)
78-
79-
Docker Offload manages the lifecycle of builders automatically. There's no need to
80-
provision or maintain infrastructure.
81-
82-
> [!NOTE]
83-
>
84-
> Docker Offload builders are currently hosted in the United States East region. Users in
85-
> other regions may experience increased latency.
86-
8755
### Running containers with Docker Offload
8856

89-
When you use Docker Offload to run containers, a Docker Desktop creates a secure
57+
When you use Docker Offload to build or run containers, a Docker Desktop creates a secure
9058
SSH tunnel to a Docker daemon running in the cloud. Your containers are started
9159
and managed entirely in that remote environment.
9260

9361
Here's what happens:
9462

9563
1. Docker Desktop connects to the cloud and triggers container creation.
96-
2. Docker Offload pulls the required images and starts containers in the cloud.
64+
2. Docker Offload builds or pulls the required images and starts containers in the cloud.
9765
3. The connection stays open while the containers run.
9866
4. When the containers stop running, the environment shuts down and is cleaned
9967
up automatically.
@@ -104,22 +72,15 @@ support nested virtualization. This makes Docker Offload ideal for developers
10472
using environments such as virtual desktops, cloud-hosted development machines,
10573
or older hardware.
10674

107-
Docker Offload also supports GPU-accelerated workloads. Containers that require
108-
GPU access can run on cloud instances provisioned with NVIDIA L4 GPUs for
109-
efficient AI inferencing, media processing, and general-purpose GPU
110-
acceleration. This enables compute-heavy workflows such as model evaluation,
111-
image processing, and hardware-accelerated CI tests to run seamlessly in the
112-
cloud.
113-
11475
Despite running remotely, features like bind mounts and port forwarding continue
11576
to work seamlessly, providing a local-like experience from within Docker Desktop
11677
and the CLI.
11778

118-
Docker Offload provisions an ephemeral cloud environment for each session. The
119-
environment remains active while you are interacting with Docker Desktop or
120-
actively using containers. If no activity is detected for about 5 minutes, the
121-
session shuts down automatically. This includes any containers, images, or
122-
volumes in that environment, which are deleted when the session ends.
79+
Docker Offload automatically transitions between active and idle states based on
80+
usage. You're only charged when actively building or running containers. When
81+
idle for more than 5 minutes, the session ends and resources are cleaned up. For
82+
details about how this works and how to configure idle timeout, see [Active and
83+
idle states](configuration.md#understand-active-and-idle-states).
12384

12485
## What's next
12586

0 commit comments

Comments
 (0)