Skip to content

Offload: update offload idle behaviour description#24829

Merged
craig-osterhout merged 5 commits into
docker:mainfrom
leocross:offload-idle-behaviour
May 22, 2026
Merged

Offload: update offload idle behaviour description#24829
craig-osterhout merged 5 commits into
docker:mainfrom
leocross:offload-idle-behaviour

Conversation

@leocross
Copy link
Copy Markdown
Contributor

Description

Updates the description of Offload session management and idle behaviour

Related issues or tickets

DCL-1716

Reviews

  • Technical review
  • Editorial review
  • Product review

@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 20, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 2987bb0
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a102a8b1e04de00096c4a2f
😎 Deploy Preview https://deploy-preview-24829--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@mslaveck1
Copy link
Copy Markdown

My edits to documentation:

Session management and idle state

Docker Offload uses session management and idle state policies to ensure fair use of cloud resources across all users.

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.

When you'll see a prompt

While Docker Offload is running, Docker Desktop shows prompts in the Dashboard to check if you're still active. Prompts appear in two cases:

  • No activity is detected for more than 3 minutes.
  • The session has been running for a long time.

When a prompt appears, you can:

  • Select Ask me again later to confirm you're still active and continue your session.
  • Select Idle now to return to an idle state immediately.
  • Do nothing, and the session returns to an idle state automatically.

What happens when your session goes idle

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.

Important
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 before your session ends.

Long session prompts

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.

@leocross leocross marked this pull request as ready for review May 20, 2026 11:39
@leocross leocross requested a review from craig-osterhout as a code owner May 20, 2026 11:39
Copy link
Copy Markdown

@docker-agent docker-agent left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: 🟢 APPROVE

Copy link
Copy Markdown
Contributor

@craig-osterhout craig-osterhout left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One small nit, otherwise lgtm

Comment thread content/manuals/offload/about.md Outdated
Co-authored-by: Craig Osterhout <craig.osterhout@docker.com>
@craig-osterhout craig-osterhout merged commit 0f9dc09 into docker:main May 22, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants