Skip to content

docker-rootless-setuptools.sh: use context after install#43061

Merged
thaJeztah merged 1 commit intomoby:masterfrom
math2001:43020-use-rootless-after-setup
Jan 4, 2022
Merged

docker-rootless-setuptools.sh: use context after install#43061
thaJeztah merged 1 commit intomoby:masterfrom
math2001:43020-use-rootless-after-setup

Conversation

@math2001
Copy link
Copy Markdown
Contributor

@math2001 math2001 commented Dec 6, 2021

- What I did

use the rootless context after installation. closes #43020

- How I did it

- How to verify it

$ contrib/dockerd-rootless-setuptool.sh install
...

[INFO] Creating CLI context "rootless"
Successfully created context "rootless"
[INFO] Use CLI context "rootless"
Current context is now "rootless"

[INFO] Make sure the following environment variables are set (or add them to ~/.bashrc):

export PATH=/usr/bin:$PATH
export DOCKER_HOST=unix:///run/user/1001/docker.sock

- Description for the changelog

docker-rootless-setuptools.sh: use the rootless context after installation

- A picture of a cute animal (not mandatory but encouraged)
🐓

@AkihiroSuda AkihiroSuda added area/rootless Rootless Mode kind/enhancement Enhancements are not bugs or new features but can improve usability or performance. labels Dec 6, 2021
Comment thread contrib/dockerd-rootless-setuptool.sh
@math2001 math2001 force-pushed the 43020-use-rootless-after-setup branch from 0d4addb to 7c17ad8 Compare December 6, 2021 06:29
Copy link
Copy Markdown
Member

@AkihiroSuda AkihiroSuda left a comment

Choose a reason for hiding this comment

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

Thanks

Copy link
Copy Markdown
Member

@thaJeztah thaJeztah left a comment

Choose a reason for hiding this comment

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

LGTM

@thaJeztah
Copy link
Copy Markdown
Member

Failure is unrelated

@thaJeztah thaJeztah merged commit 8308f74 into moby:master Jan 4, 2022
@AkihiroSuda AkihiroSuda added this to the 21.xx milestone Jan 4, 2022
aevesdocker added a commit to docker/docs that referenced this pull request Sep 8, 2025
…uplicated info (#23302)

<!--Delete sections as needed -->

https://docs.docker.com/engine/security/rootless/ was too lengthy and
giving a false sense that Rootless mode was quite clunky and hard to
use, although actually it can be just set up in a single command:
```
dockerd-rootless-setuptool.sh install
```

## Description

<!-- Tell us what you did and why -->

### Commit 1: `engine/security/rootless: split to multiple pages`
This commit only splits the page.
The content will be updated in subsequent commits.

### Commit 2: `engine/security/rootless: remove outdated/duplicated
info`

Setup:
- `dockerd-rootless-setuptool.sh` has been improved to show help when
the prerequisites are not satisfied.
Users no longer need to read the **lengthy** "prerequisites"
documentation unless they encounter issues.

- The document had duplicated descriptions about dbus, uidmap, and
machinectl stuffs in several places.

Graph drivers:
- Rootless OverlayFS has been merged into the upstream since kernel
5.11:
  torvalds/linux@459c7c5 .
  Ubuntu no longer patches the kernel.

- FUSE-OverlayFS is typically no longer needed on the current supported
distros,
  except EL 8.

SELinux:
- Remove a workaround for an issue that was already fixed in Docker
Engine v20.10.8.

CLI:
- `docker context use rootless` no longer needs to be executed manually,
  since Docker v23. (moby/moby#43061)

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [X] Technical review
- [X] Editorial review
- [ ] Product review


## Preview

https://deploy-preview-23302--docsdocker.netlify.app/engine/security/rootless/

---------

Signed-off-by: Akihiro Suda <[email protected]>
Co-authored-by: Paweł Gronowski <[email protected]>
Co-authored-by: Allie Sadler <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/rootless Rootless Mode impact/changelog kind/enhancement Enhancements are not bugs or new features but can improve usability or performance. status/2-code-review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

dockerd-rootless-setuptool.sh: run docker context use rootless by default

3 participants