Skip to content

Commit 87594e5

Browse files
committed
Update offload session management description
1 parent 1c989bd commit 87594e5

1 file changed

Lines changed: 20 additions & 21 deletions

File tree

content/manuals/offload/about.md

Lines changed: 20 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -69,33 +69,32 @@ Docker](https://www.docker.com/pricing/contact-sales/) to explore options.
6969

7070
### Session management and idle state
7171

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.
7473

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.
7975

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
8277

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:
8579

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.
9182

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.
9687

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.
9998

10099
## What's next
101100

0 commit comments

Comments
 (0)