Skip to content

Commit d72c32e

Browse files
offload: product updates (#24487)
<!--Delete sections as needed --> ## Description Updates for upcoming Offload release. Preview: - https://deploy-preview-24487--docsdocker.netlify.app/offload/ - https://deploy-preview-24487--docsdocker.netlify.app/desktop/setup/vm-vdi/#use-docker-offload ## Related issues or tickets ENGDOCS-3216 DCL-1433 #24089 ## 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 6eee5ea commit d72c32e

File tree

11 files changed

+169
-188
lines changed

11 files changed

+169
-188
lines changed

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

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -106,8 +106,7 @@ select **Account**.
106106

107107
> [!NOTE]
108108
>
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.
109+
> Docker Offload isn't included in the core Docker subscription plans. To make Docker Offload available, you must [contact sales](https://www.docker.com/products/docker-offload/) and subscribe.
111110
112111
To manage Docker Offload access for your organization, use [Settings
113112
Management](/manuals/enterprise/security/hardened-desktop/settings-management/_index.md):

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

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,8 +35,9 @@ Docker Desktop via an SSH tunnel. Despite running remotely, features like bind
3535
mounts and port forwarding continue to work seamlessly, providing a local-like
3636
experience. To use Docker Offload:
3737

38-
To get started using Docker Offload, see the [Docker Offload
39-
quickstart](/offload/quickstart/).
38+
For more information, see the [Docker Offload product
39+
page](https://www.docker.com/products/docker-offload/) and the [Docker Offload
40+
documentation](/offload/).
4041

4142
## Virtual desktop support when using nested virtualization
4243

content/manuals/offload/_index.md

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,11 @@
11
---
22
title: Docker Offload
33
weight: 15
4-
description: Find documentation on Docker Offload to help you build and run your container images faster, both locally and in CI
4+
description: Find documentation on Docker Offload to help you offload containers to the cloud.
55
keywords: build, cloud, cloud build, remote builder
66
params:
77
sidebar:
88
group: Products
9-
badge:
10-
color: violet
11-
text: Early Access
129

1310
grid:
1411

@@ -23,12 +20,12 @@ grid:
2320
link: /offload/about/
2421

2522
- title: Configure
26-
description: Set up and customize your cloud build environments.
23+
description: Configure Docker Offload settings for your organization and Docker Desktop.
2724
icon: tune
2825
link: /offload/configuration/
2926

30-
- title: Usage and billing
31-
description: Learn about Docker Offload usage and billing, and how to monitor your cloud resources.
27+
- title: Usage
28+
description: Learn about Docker Offload usage and how to monitor your cloud resources.
3229
icon: monitor_heart
3330
link: /offload/usage/
3431

content/manuals/offload/about.md

Lines changed: 38 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -6,46 +6,31 @@ description: Learn about Docker Offload, its features, and how it works.
66
keywords: cloud, offload, vdi
77
---
88

9+
{{< summary-bar feature_name="Docker Offload" >}}
10+
911
Docker Offload is a fully managed service for building and running containers in
1012
the cloud using the Docker tools you already know, including Docker Desktop, the
1113
Docker CLI, and Docker Compose. It extends your local development workflow into a
1214
scalable, cloud-powered environment, enabling developers to work efficiently even
1315
in virtual desktop infrastructure (VDI) environments or systems that don't support
1416
nested virtualization.
1517

16-
17-
1818
## Key features
1919

2020
Docker Offload includes the following capabilities to support modern container
2121
workflows:
2222

2323
- Ephemeral cloud runners: Automatically provision and tear down cloud
2424
environments for each container session.
25-
- Hybrid workflows: Seamlessly transition between local and remote execution
26-
using Docker Desktop or CLI.
2725
- Secure communication: Use encrypted tunnels between Docker Desktop and cloud
2826
environments with support for secure secrets and image pulling.
2927
- Port forwarding and bind mounts: Retain a local development experience even
3028
when running containers in the cloud.
31-
- VDI-friendly: [Use Docker Desktop](../desktop/setup/vm-vdi.md) in virtual desktop environments or systems that
32-
don't support nested virtualization.
33-
34-
## Why use Docker Offload?
35-
36-
Docker Offload is designed to support modern development teams working across
37-
local and cloud environments. It helps you:
38-
39-
- Offload heavy builds and runs to fast, scalable infrastructure
40-
- Run containers that require more resources than your local setup can provide
41-
- Use Docker Compose to manage complex, multi-service apps that need cloud
42-
resources
43-
- Maintain consistent environments without managing custom infrastructure
44-
- Develop efficiently in restricted or low-powered environments like VDIs
29+
- VDI-friendly: [Use Docker Desktop](../desktop/setup/vm-vdi.md) in virtual
30+
desktop environments or systems that don't support nested virtualization.
4531

46-
Docker Offload is ideal for high-velocity development workflows
47-
that need the flexibility of the cloud without sacrificing the simplicity of
48-
local tools.
32+
For more information, see the [Docker Offload product
33+
page](https://www.docker.com/products/docker-offload/).
4934

5035
## How Docker Offload works
5136

@@ -54,15 +39,15 @@ Docker Desktop to secure, dedicated cloud resources.
5439

5540
### Running containers with Docker Offload
5641

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

6146
Here's what happens:
6247

6348
1. Docker Desktop connects to the cloud and triggers container creation.
6449
2. Docker Offload builds or pulls the required images and starts containers in the cloud.
65-
3. The connection stays open while the containers run.
50+
3. The connection stays open while the containers run and you remain active.
6651
4. When the containers stop running, the environment shuts down and is cleaned
6752
up automatically.
6853

@@ -76,11 +61,36 @@ Despite running remotely, features like bind mounts and port forwarding continue
7661
to work seamlessly, providing a local-like experience from within Docker Desktop
7762
and the CLI.
7863

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).
64+
### Cloud resources
65+
66+
Docker Offload uses cloud hosts with 4 vCPUs and 8 GiB of memory. If you have
67+
different requirements, [contact
68+
Docker](https://www.docker.com/pricing/contact-sales/) to explore options.
69+
70+
### Session management and idle state
71+
72+
Docker Offload implements session management and idle state policies to ensure
73+
fair use across all users.
74+
75+
Here's how session management works:
76+
77+
1. You start a new Docker Offload session. You can only have one session active
78+
at a time.
79+
2. You receive periodic prompts (every 1 to 3 hours) in the Docker Desktop Dashboard
80+
to determine if you are still active. When the prompt appears, you can choose to:
81+
- Select **Resume** in the prompt to confirm you're still active and
82+
continue your session.
83+
- Do nothing, select **Cancel**, or dismiss the prompt. You have a
84+
5-minute grace period. After the grace period, if you still haven't
85+
responded, your session enters a 5-minute idle timeout period. During
86+
either period, you can select **Resume** to continue your session and
87+
preserve all containers, images, and volumes.
88+
3. If the idle timeout period exceeds 5 minutes without resuming, the session
89+
is suspended (the remote connection is suspended and containers stop
90+
running).
91+
4. After 8 hours of cumulative usage, the periodic prompts become more frequent.
92+
If you do not respond to a prompt and the idle timeout expires, your session
93+
ends and any containers, images, or volumes are deleted.
8494

8595
## What's next
8696

content/manuals/offload/configuration.md

Lines changed: 10 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -8,69 +8,24 @@ keywords: cloud, configuration, settings, offload
88

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

11-
You can configure Docker Offload settings at different levels depending on your role. Organization owners can manage
12-
settings for all users in their organization, while individual developers can configure their own Docker Desktop
11+
You can configure Docker Offload settings at different levels depending on your
12+
role. Organization owners can manage settings for all users in their
13+
organization, while individual developers can configure their own Docker Desktop
1314
settings when allowed by their organization.
1415

1516
## Manage settings for your organization
1617

17-
For organization owners, you can manage Docker Offload settings for all users in your organization. For more details,
18-
see [Manage Docker products](../admin/organization/manage-products.md). To view usage and configure billing for Docker
19-
Offload, see [Docker Offload usage and billing](/offload/usage/).
18+
For organization owners, you can manage Docker Offload settings for all users in
19+
your organization. For more details, see [Manage Docker
20+
products](../admin/organization/manage-products.md). To view usage for Docker
21+
Offload, see [Docker Offload usage](/offload/usage/).
2022

2123
## Configure settings in Docker Desktop
2224

23-
For developers, you can manage Docker Offload settings in Docker Desktop. To manage settings:
25+
For developers, you can enable or disable Docker Offload in Docker Desktop if
26+
allowed by your organization. To manage this setting:
2427

2528
1. Open the Docker Desktop Dashboard and sign in.
2629
2. Select the settings icon in the Docker Desktop Dashboard header.
2730
3. In **Settings**, select **Docker Offload**.
28-
29-
Here you can:
30-
31-
- Toggle **Enable Docker Offload**. When enabled, you can start Offload sessions.
32-
- Select **Idle timeout**. This is the duration of time between no activity and Docker Offload entering idle mode.
33-
For details about idle timeout, see [Understand active and idle states](#understand-active-and-idle-states).
34-
35-
### Understand active and idle states
36-
37-
Docker Offload automatically transitions between active and idle states to help
38-
you control costs while maintaining a seamless development experience.
39-
40-
#### When your session is active
41-
42-
Your Docker Offload environment is active when you're building images, running
43-
containers, or actively interacting with them, such as viewing logs or
44-
maintaining an open network connection. During active state:
45-
46-
- Usage is charged
47-
- A remote Docker Engine is connected to your local machine
48-
- All container operations execute in the cloud environment
49-
50-
#### When your session is idle
51-
52-
When there's no activity, Docker Offload transitions to idle state. During idle
53-
state:
54-
55-
- You are not charged for usage
56-
- The remote connection is suspended
57-
- No containers are running in the cloud
58-
59-
The idle transition delay can be configured in Docker Desktop settings, ranging
60-
from 10 seconds to 1 hour. This setting determines how long Docker Offload
61-
waits after detecting inactivity before transitioning to idle state.
62-
63-
#### How your session is preserved
64-
65-
If your session has been idle for less than 5 minutes and you resume activity,
66-
your previous containers and images are preserved and remain available. This
67-
allows you to pick up right where you left off.
68-
69-
However, if the idle period exceeds 5 minutes, a new session starts with a
70-
clean environment and any containers, images, or volumes from the previous
71-
session are deleted.
72-
73-
> [!NOTE]
74-
>
75-
> Transitioning from active to idle and back to active within 5 minutes will be
76-
> charged as continuous usage.
31+
4. Toggle **Enable Docker Offload**. When enabled, you can start Offload sessions.

content/manuals/offload/feedback.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ title: Give feedback
55
weight: 900
66
---
77

8-
98
There are several ways you can provide feedback on Docker Offload.
109

1110
## Quick survey

0 commit comments

Comments
 (0)