Skip to content

install: warn when Docker's folder is on an overlay root - #277

Merged
inkly merged 1 commit into
mainfrom
fix/warn-docker-on-overlay-root
Nov 18, 2026
Merged

inkly merged 1 commit into
mainfrom
fix/warn-docker-on-overlay-root

Conversation

@inkly

@inkly inkly commented Nov 18, 2026

Copy link
Copy Markdown
Collaborator

On a system whose root is itself an overlay (FriendlyElec images for the NanoPi R5S, reported on Discord), Docker cannot unpack images:

failed to extract layer ... to overlayfs as "extract-...": failed to convert whiteout file "etc/alternatives/.wh.pinentry": operation not permitted

The installer now looks at the file system under /var/lib/docker (or /var/lib when Docker is not there yet) and prints a notice with the two ways out: Docker's folder on a real disk, or the overlay root turned off as the maker documents. The install goes on.

  • scripts/test-install-dependencies.sh: an overlay is said and does not end the install; ext4 says nothing.
  • Not tried on a real overlay-root box. A data-root set in daemon.json is not read.
  • In a container whose root is an overlay and that has no /var/lib/docker yet, the notice shows too.

On FriendlyElec images the root is an overlay; Docker cannot make its own
overlay layers there and a pull ends at 'failed to convert whiteout file ...
operation not permitted'. The installer now says so before Docker is
installed or used, and goes on.
@inkly
inkly marked this pull request as ready for review November 18, 2026 00:53
@inkly
inkly merged commit 68dea57 into main Nov 18, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant