doc/quick-start/install-docker.md

   1 # Install Docker Engine
   2
   3 We will install `docker`.
   4
   5 Minimal versions: docker 1.17
   6
   7 You can ensure docker is working properly by using
   8 `$ docker run hello-world`.
   9
  10 ## Install Docker Engine
  11
  12 The recommend platform for Tuleap development is Fedora. It's the base
  13 image used by most of the Tuleap developers, you are more likely to get
  14 help with this base.
  15
  16 ### Installing Docker on Fedora
  17
  18 **Fedora 36+**
  19
  20 We recommend you run fedora's version of docker (instead of Docker CE).
  21
  22 However, there will be some configuration needed to run everything:
  23
  24 First, you need to raise the default ulimits:
  25
  26 ``` bash
  27 $> sudo vim /etc/sysconfig/docker
  28     ...
  29     --default-ulimit nofile=2048:2048 \
  30     ...
  31 $> sudo systemctl edit docker.service
  32 [Service]
  33 LimitNOFILE=2048
  34 ```
  35
  36 Then, SELinux must be disabled:
  37
  38 ``` bash
  39 $> sudo setenforce disabled
  40 $> vim /etc/selinux/config
  41 SELINUX=permissive
  42 ```
  43
  44 Finally, restart everything:
  45
  46 ``` bash
  47 $> sudo systemctl daemon-reload
  48 $> sudo systemctl restart docker.service
  49 ```
  50
  51 ### Installing Docker on Ubuntu
  52
  53 Follow the official Docker documentation: [Installation on
  54 Ubuntu](https://docs.docker.com/engine/install/ubuntu/).
  55
  56 ### Installing Docker with Docker Desktop
  57
  58 Go to https://www.docker.com/products/docker-desktop/ and download Docker for linux.
  59
  60 ### Installing Docker on macOS
  61
  62 Go to <https://docs.docker.com/desktop/install/mac-install/> and
  63 download Docker for Mac. It will install all you need to run Tuleap
  64 containers.
  65
  66 ## Next
  67
  68 [You are ready to run Tuleap](./run-tuleap.md)