Commit Graph

38 Commits

Author SHA1 Message Date
Sebastiaan van Stijn afeaca91a8
update references to docker engine to v24.0
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2023-05-19 15:05:10 +02:00
Sebastiaan van Stijn 6cf04bb21f
rootless: update example to use v23.0
Also remove mentions of obsolete version of docker that introduced rootless.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2023-05-03 15:07:00 +02:00
Justin Chadwell ad45d2d936 lint: tidy spaces inside spans 2022-07-28 11:27:10 +01:00
Sebastiaan van Stijn 67e63bcd87
Updates docs for s390x for latest version (#15245)
Signed-off-by: Prabhav Thali <Prabhav.Thali1@ibm.com>
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

Co-authored-by: Prabhav Thali <Prabhav.Thali1@ibm.com>
2022-07-27 21:51:52 +01:00
Fabio Guarini 0a07674d6b
doc: fix typo
Removed unnecessary 'and'
2022-06-30 22:18:16 -04:00
Kevin Köllmann 5bcc324688
Fixed rootlesskit binary path, mention daemon restart (#13932)
* Fixed rootlesskit binary path, mention daemon restart

`rootlesskit` lives at `/usr/bin/rootlesskit`. After setting `CAP_NET_BIND_SERVICE` capability daemon has to be restarted.

* Changed rootlesskit binary path to be dynamically resolved
2021-12-17 11:22:30 +00:00
Sebastiaan van Stijn b97db3206d
Merge pull request #13417 from gqqnbig/patch-1
Unset environment variables when uninstall rootless docker
2021-08-27 15:32:53 +02:00
Akihiro Suda 0908c993fe
rootless: suggest creating `docker.service.d/override.conf`, without modifying `docker.service` itself
Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2021-08-27 18:07:32 +09:00
Akihiro Suda de0d13322a
rootless: remove outdated SELinux workaround for `/run/xtables.lock`
The SELinux workaround for `/run/xtables.lock` is no longer needed
since Docker 20.10.8 (moby/moby PR 42462)

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2021-08-27 17:29:20 +09:00
Akihiro Suda 0416aeb03f
rootless: recommend installing `dbus-user-session`
rootless+cgroup2+systemd fails with a cryptic error when dbus-user-session dpkg is not installed.

```
docker: Error response from daemon: OCI runtime create failed: container_linux.go:380: starting container process caused: process_linux.go:385: applying cgroup configuration for process caused: error while starting unit "docker
-931c15729b5a968ce803784d04c7421f791d87e5ca1891f34387bb9f694c488e.scope" with properties [{Name:Description Value:"libcontainer container 931c15729b5a968ce803784d04c7421f791d87e5ca1891f34387bb9f694c488e"} {Name:Slice Value:"use
r.slice"} {Name:PIDs Value:@au [4529]} {Name:Delegate Value:true} {Name:MemoryAccounting Value:true} {Name:CPUAccounting Value:true} {Name:IOAccounting Value:true} {Name:TasksAccounting Value:true} {Name:DefaultDependencies Val
ue:false}]: read unix @->/run/systemd/private: read: connection reset by peer: unknown.
```

ref: moby/moby issue 42793

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2021-08-27 17:26:18 +09:00
Akihiro Suda 8e48f0de0e
rootless: update for Debian 11
- sysctl `kernel.unprivileged_userns_clone=1` is no longer needed

- Recommend fuse-overlayfs.
  Debian kernel has modprobe option `permit_mounts_in_userns=1` but
  still unstable (moby/moby issue 42302)

- Now apt repo has relatively recent version of slirp4netns (1.0.1)

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2021-08-27 17:26:18 +09:00
QQ喵 d3a118cc9d
Unset environment variables PATH and DOCKER_HOST 2021-08-27 11:14:57 +08:00
Sebastiaan van Stijn 599660d47f
s390x install steps updates
- fix sort order in output
- some minor other changes

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-08-26 11:11:00 +02:00
anujajakhade b781519e18 Updated docs for s390x for latest version
Signed-off-by: Anuja Jakhade <anujajakhade@gmail.com>
2021-08-20 04:36:10 +00:00
Sebastiaan van Stijn 1583678203
Add missing code-hints, and minor markdown edits
- Add missing code-hints (console, yaml)
- Consistently add an empty line after code-blocks
- Combine some examples where the output and the command were
  put in separate blocks. With the "console" code-hint, this
  is no longer nescessary.
- fix indentation in cloud/ecs-integration.md, which caused the
  numbered-list to be interrupted.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-08-16 12:59:23 +02:00
Sebastiaan van Stijn 2aa67d2670
Fix redirects, add notes about available arches, and minor edits
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2021-08-05 21:30:49 +02:00
Nirman Narang 055e6fd68a
DOCS: Added support for arch s390x for Ubuntu, RHEL and SLES
Added .md files for SLES and RHEL engine installation. Added indexing to _data/toc.yaml and engine/install/index.md. Modified engine/install/index.md, includes/install-script.md, engine/security/rootless.md, storage/storagedriver/device-mapper-driver.md, and storage/storagedriver/select-storage-driver.md to add info for added RHEL and SLES support. Modified engine/install/ubuntu.md to add s390x repos and other info. Added tab target for RHEL and SLES to engine/security/rootless.md along with other info.

Signed-off-by: Nirman Narang <narang@us.ibm.com>
2021-08-05 19:48:09 +02:00
Akihiro Suda 16284c47cb
Follow-up to #13275 ("Add note about NFS mounts for rootless data-root")
Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2021-08-04 18:30:07 +09:00
Eli Uriegas 3ef4de1180
Add not about NFS mounts for rootless data-root
NFS mounts are not currently supported for rootless data-root so there should probably be a note about it so no one gets confused when it doesn't work.

Errors for running rootless containers when your data-root is an NFS mount look like:

```
docker: failed to register layer: ApplyLayer exit status 1 stdout:  stderr: open /root/.bash_logout: permission denied.
```
2021-08-03 11:35:19 -07:00
Jem Bishop c53a05b8c1
Workaround for outdated slirp4netns on debian (#13029)
* Workaround for outdated slirp4netns on debian

I had issue on debian 11 where the package on the 
main apt repositories was too old. This provides workaround, by 
adding the testing repos to sources list then upgrading slirp4netns

* pr review

- add console tag
- add newline before console code block
- remove the installation instructions to `slirp4netns` and link to the releases page, which will have it anyway.

* pr review

- add in suggested comment about vpnkit
2021-07-01 17:11:09 +01:00
Sebastiaan van Stijn e146c7f2cd
Merge pull request #12588 from aro5000/update_rootless_docker
Adding docker.socket to also be in disable command for rootless docker
2021-05-05 21:16:26 +02:00
Akihiro Suda 5f47c24504
rootless: update for v20.10.6
- btrfs is now supported (moby/moby PR 42253)
- CLI context "rootless" is now created by default (moby/moby PR 42109)

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2021-04-14 14:47:57 +09:00
Aaron Stults 1c828097a6 Adding docker.socket to also be disabled otherwise any docker command run will re-enable docker.service 2021-03-27 16:02:43 -06:00
Akihiro Suda 690e0010aa
update rootless docs
= _includes/install-script.md, engine/install/linux-postinstall.md =
- Remove "Rootless mode is currently available as an experimental feature."
  Close issue 12050

= engine/security/rootless.md =
== "Prerequiresites" section ==
- Remove information about old distros (Debian 9, CentOS 7.5-7.6)

== "Distribution-specific hint" section ==
- Tabified (`<div class="tab-content" />`)

== "Known limitations" section ==
- Kernel 5.11 supports rootless overlayfs, without the Ubuntu/Debian patch.

== "Install" section ==
- Promote RPM/DEB installation over TGZ installation.
  See docker/roadmap issue 188

== "Uninstall" section ==
- Add "Uninstall" section.
  Close issue 12053

== "Usage" section ==
- Added more information about systemd
- Move `nsenter` tips to "Tips for debugging" subsection under "Troubleshooting" section

== "Best practice" section ==
- Remove guide for `lxc-user-nic` network driver due to immaturity.
  Will be brought back in future.
  See rootless-containers/rootlesskit issue 138 .

== "Troubleshooting" section ==
- Add a guide for "can't open lock file /run/xtables.lock: Permission denied" (SELinux).
  See moby/moby issue 41230

- Add a guide for "failed to register layer: ApplyLayer exit status 1 ..." (NFS).
  Close docker/for-linux issue 1172

- Improve guides for slirp4netns.

- Remove v19.03 information (e.g., "cgroup v2 is unsupported, use cgroup v1")

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2021-02-12 19:36:51 +09:00
Akihiro Suda 1976c2178c
v20.10 docs for cgroup v2 and rootless
* Docker now supports cgroup v2 (both rootful and rootless)
* Rootless mode graduated from experimental
* New storage driver: fuse-overlayfs

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2020-11-12 12:47:16 +09:00
Fabian M 65d98b3cd9
Fix syntax: Add missing backtick 2020-11-08 22:33:15 +01:00
Sebastiaan van Stijn 393d3f6566
Add rel="noopener" to external links
See https://web.dev/external-anchors-use-rel-noopener/

Using noopener, as that addresses the security issue. "noreferer" blocks
the REFERER header, which may still be useful for some target URLs.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-10-12 13:09:30 +02:00
Ryo Ota 6469b210cc
use .tgz instead of .tar.gz 2020-09-04 07:36:23 +09:00
Akihiro Suda a7e2591552
rootless.md: fix markdown
Fix #11017

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2020-06-26 14:27:33 +09:00
Akihiro Suda b7eec33cfe
rootless.md: fix a typo (#11013) 2020-06-18 09:08:55 +01:00
Usha Mandya f91c2a28f6
Rootless Docker: Style edits and minor updates (#11001)
Rootletts: Style edits and minor updates, and fix prereq example
2020-06-17 11:33:24 +02:00
Akihiro Suda a06b01802c
rootless.md: massive update
* Add Ubuntu 20.04
* Remove Fedora 30 (EOL)
* `docker run --net=host` does not work in the most expected way
* Allow installation as the root
* Nightly channel
* `docker context create rootless`
* `DOCKER_HOST=ssh://...`
* Alternatives to cgroup flags (`docker run --cpus --memory --pids-limit`)
* A bunch of troubleshooting tips

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2020-06-16 19:20:18 +09:00
Flavien Berwick 0d8d653f4f
Auto-restart of Docker rootless on boot requires an additional command
Related to issue [#10770](https://github.com/docker/docker.github.io/issues/10770)
2020-05-07 19:10:04 +02:00
ajay143444 aa57de37d3
Few corrections and suggestions in doc (#10728)
* Removed is from line 80

Removed is from line 80 as this is not required

* changed text to link at line 129

changed text to link at line 129 to make it easy for user to navigate

* changed the URL to link

changed the URL to link for easy navigation

* added these before flags in line 186

added these before flags in line 186

Co-Authored-By: Sebastiaan van Stijn <thaJeztah@users.noreply.github.com>
2020-05-01 18:30:28 +02:00
scott-vsi e7eedf3b7f
fix link (#10402)
fix a link that was possibly broken by automatic text formatting/wrapping
2020-03-09 10:19:45 +00:00
pcworld e1f41c15ed
rootless.md: Fix typo in path 2020-03-06 18:47:46 +01:00
LORIS INTERGALACTIQUE 711567c5af
Fixed typos on the rootless mode page (#10330)
* Fixed typos

* Minor wording update

Co-authored-by: Usha Mandya <47779042+usha-mandya@users.noreply.github.com>
2020-02-21 17:52:37 +00:00
Akihiro Suda 40747fcca7 Add "Run the Docker daemon as a non-root user (Rootless mode)"
Add "Run the Docker daemon as a non-root user (Rootless mode)":
`engine/security/rootless.md`

The content is based on https://github.com/moby/moby/blob/master/docs/rootless.md

`rootless.md` in `moby/moby` will be replaced of the link to
the `docs.docker.com` page compiled from `rootless.md` in this repo.

Signed-off-by: Akihiro Suda <akihiro.suda.cz@hco.ntt.co.jp>
2019-11-15 16:02:08 +09:00