You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/manuals/offload/about.md
+20-21Lines changed: 20 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -69,33 +69,32 @@ Docker](https://www.docker.com/pricing/contact-sales/) to explore options.
69
69
70
70
### Session management and idle state
71
71
72
-
Docker Offload implements session management and idle state policies to ensure
73
-
fair use across all users.
72
+
Docker Offload uses session management and idle state policies to ensure fair use of cloud resources across all users.
74
73
75
-
When Docker Desktop shows it is in an **Offload idle** state it waits for activity on
76
-
the Docker API and only connects to a cloud environment when required. A user can only
77
-
maintain one Docker Offload session at a time. Once connected and in a **Offload running**
78
-
state it will remain connected as long as it detects continued activity.
74
+
Each user can run one Docker Offload session at a time. When Docker Desktop is in an **Offload idle** state, it waits for activity on the Docker API and only connects to a cloud environment when needed. Once connected, the session moves to an **Offload running** state and stays connected as long as Docker detects activity. Activity includes any Docker API call, a running container, or an active build.
79
75
80
-
While using Docker Offload you will receive notifications and prompts in the Docker Desktop
81
-
Dashboard to determine if you are still active in these two cases:
76
+
#### When you'll see a prompt
82
77
83
-
1. If no activity is detected for more than 3 minutes.
84
-
2. If the session has been running for a long time.
78
+
While Docker Offload is running, Docker Desktop shows prompts in the Dashboard to check if you're still active. Prompts appear in two cases:
85
79
86
-
When the prompt appears, you can choose to:
87
-
- Select **Ask me again later** in the prompt to confirm you're still active and
88
-
continue your session.
89
-
- Select **Idle now** in the prompt to immediately return to an idle state.
90
-
- Do nothing and it will automatically return to an idle state.
80
+
1. No activity is detected for more than 3 minutes.
81
+
2. The session has been running for a long time.
91
82
92
-
After returning to an idle state there is a 5 minute grace period where the session
93
-
can be resumed by triggering new Docker activity. If the idle period exceeds 5 minutes
94
-
without resuming, the session is terminated and the remote environment and any containers,
95
-
images, or volumes are deleted.
83
+
When a prompt appears, you can:
84
+
- Select **Ask me again later** to confirm you're still active and continue your session.
85
+
- Select **Idle now** to return to an idle state immediately.
86
+
- Do nothing, and the session returns to an idle state automatically.
96
87
97
-
Long session prompts are triggered every 3 hours during a session. After 8 hours of cumulative
98
-
usage, the prompts are triggered every hour.
88
+
#### What happens when your session goes idle
89
+
90
+
After your session returns to an idle state, there is a 5-minute grace period. You can resume the session during this time by running any Docker command.
91
+
92
+
> [!IMPORTANT]
93
+
> If the idle period exceeds 5 minutes without activity, the session is terminated. Docker Offload environments are ephemeral, so the remote environment and any containers, images, or volumes in it are deleted. To keep work between sessions, push images to a registry such as [Docker Hub](https://docs.docker.com/docker-hub/) before your session ends.
94
+
95
+
#### Long session prompts
96
+
97
+
Long session prompts appear every 3 hours during a session. After 8 hours of cumulative usage in a day, prompts appear every hour. The 8-hour counter resets at the start of each day.
0 commit comments