Skip to content

Commit 1977ba2

Browse files
offload: enterprise beta
Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
1 parent 577bf3e commit 1977ba2

File tree

20 files changed

+308
-272
lines changed

20 files changed

+308
-272
lines changed

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

Lines changed: 49 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,52 @@ 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. If GPU support is enabled for your organization's subscription, configure the
131+
**Enable Docker Offload GPU Support** setting to control whether GPU support
132+
is available in Docker Desktop. You can configure this setting in five
133+
states:
134+
- **Always enabled**: GPU support is always enabled and users cannot disable it.
135+
- **Enabled**: GPU support is enabled by default but users can disable it in Docker Desktop
136+
settings.
137+
- **Disabled**: GPU support is disabled by default but users can enable it in Docker Desktop
138+
settings.
139+
- **Always disabled**: GPU support is disabled and users cannot enable it. The option is
140+
visible but locked.
141+
- **User defined**: No enforced default. Users choose whether to enable or disable GPU support in their
142+
Docker Desktop settings.
143+
1. Select **Save**.
144+
145+
For more details on Settings Management, see the [Settings
146+
reference](/manuals/enterprise/security/hardened-desktop/settings-management/settings-reference.md#enable-docker-offload).
147+
101148
{{< /tab >}}
102149
{{< /tabs >}}
103150

@@ -110,6 +157,8 @@ To view usage for Docker products:
110157
- Docker Build Cloud: View the **Build minutes** page in [Docker Build Cloud](http://app.docker.com/build).
111158
- Docker Scout: View the [**Repository settings** page](https://scout.docker.com/settings/repos) in Docker Scout.
112159
- Testcontainers Cloud: View the [**Billing** page](https://app.testcontainers.cloud/dashboard/billing) in Testcontainers Cloud.
160+
- Docker Offload: View the **Offload** > **Offload overview** page in [Docker Home](https://app.docker.com/). For more details, see
161+
[Docker Offload usage and billing](/offload/usage/).
113162

114163
If your usage or seat count exceeds your subscription amount, you can
115164
[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: 28 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -906,13 +906,37 @@ 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.
921+
922+
#### Enable Docker Offload GPU Support
923+
924+
| Default value | Accepted values | Format |
925+
|---------------|-----------------|----------|
926+
| `false` | `true`, `false` | Boolean |
927+
928+
- **Description:** Enable GPU support for Docker Offload features.
929+
- **OS:** {{< badge color=blue text="All" >}}
930+
- **Use case:** Enable GPU-accelerated workloads in Docker Offload.
931+
- **Configure this setting with:**
932+
- **Docker Offload** settings in [Docker Desktop GUI](/manuals/desktop/settings-and-maintenance/settings.md)
933+
- Settings Management: `enableCloudGPUSupport` setting in the [`admin-settings.json` file](/manuals/enterprise/security/hardened-desktop/settings-management/configure-json-file.md)
934+
- Settings Management: **Enable Docker Offload GPU Support** setting in the [Admin Console](/manuals/enterprise/security/hardened-desktop/settings-management/configure-admin-console.md)
935+
936+
> [!NOTE]
937+
>
938+
> This setting requires Docker Offload to be enabled first and is only available when GPU support capability is enabled
939+
> for the organization.
916940
917941
### Enable Wasm
918942

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

10471071
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.
10481072

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-
10601073
### Block `docker load`
10611074

10621075
| Default value | Accepted values | Format |

content/manuals/offload/_index.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -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,7 +55,9 @@ 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
58+
enables developers to work efficiently in virtual desktop infrastructure (VDI)
59+
environments or systems that don't support nested virtualization, while also
60+
providing cloud infrastructure for fast, consistent builds and compute-heavy
5961
workloads like running LLMs or machine learning pipelines.
6062

6163
In the following topics, learn about Docker Offload, how to set it up, use it

content/manuals/offload/about.md

Lines changed: 14 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -3,39 +3,36 @@ 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, on-demand gpu, gpu
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.
1515

1616
Docker Offload also supports GPU-accelerated instances, allowing you to
17-
containerize and run compute-intensive workloads such as Docker Model Runner and
17+
containerize and run compute-intensive workloads such as running models and
1818
other machine learning or data processing tasks that benefit from GPU.
1919

2020
## Key features
2121

2222
Docker Offload includes the following capabilities to support modern container
2323
workflows:
2424

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

4138
## Why use Docker Offload?
@@ -44,7 +41,6 @@ Docker Offload is designed to support modern development teams working across
4441
local and cloud environments. It helps you:
4542

4643
- Offload heavy builds and runs to fast, scalable infrastructure
47-
- Accelerate feedback loops in development and testing
4844
- Run containers that require more resources than your local setup can provide
4945
- Build and run AI apps with instant access to GPU-powered environments
5046
- Use Docker Compose to manage complex, multi-service apps that need cloud
@@ -61,39 +57,16 @@ local tools.
6157
Docker Offload replaces the need to build or run containers locally by connecting
6258
Docker Desktop to secure, dedicated cloud resources.
6359

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-
8760
### Running containers with Docker Offload
8861

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

9366
Here's what happens:
9467

9568
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.
69+
2. Docker Offload builds or pulls the required images and starts containers in the cloud.
9770
3. The connection stays open while the containers run.
9871
4. When the containers stop running, the environment shuts down and is cleaned
9972
up automatically.
@@ -105,7 +78,7 @@ using environments such as virtual desktops, cloud-hosted development machines,
10578
or older hardware.
10679

10780
Docker Offload also supports GPU-accelerated workloads. Containers that require
108-
GPU access can run on cloud instances provisioned with NVIDIA L4 GPUs for
81+
GPU access can run on cloud instances provisioned with NVIDIA GPUs for
10982
efficient AI inferencing, media processing, and general-purpose GPU
11083
acceleration. This enables compute-heavy workflows such as model evaluation,
11184
image processing, and hardware-accelerated CI tests to run seamlessly in the
@@ -115,11 +88,11 @@ Despite running remotely, features like bind mounts and port forwarding continue
11588
to work seamlessly, providing a local-like experience from within Docker Desktop
11689
and the CLI.
11790

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.
91+
Docker Offload automatically transitions between active and idle states based on
92+
usage. You're only charged when actively building or running containers. When
93+
idle for more than 5 minutes, the session ends and resources are cleaned up. For
94+
details about how this works and how to configure idle timeout, see [Active and
95+
idle states](configuration.md#understand-active-and-idle-states).
12396

12497
## What's next
12598

0 commit comments

Comments
 (0)