Binaries

important

This page contains information on how to install Docker using binaries. These
instructions are mostly suitable for testing purposes. We do not recommend
installing Docker using binaries in production environments as they don’t have automatic security updates. The Linux binaries described on this
page are statically linked, which means that vulnerabilities in build-time
dependencies are not automatically patched by security updates of your Linux
distribution.

update binary is also slightly more involved when compare to Docker package
instal using a package manager or through Docker Desktop , as it require
( manually ) update the instal version whenever there is a new release of
Docker .

Also, static binaries may not include all functionalities provided by the dynamic
packages.

On Windows andMac, we recommend that you install
Docker Desktop
instead. For Linux, we recommend that you follow the instructions specific for
your distribution.

If you want to try Docker or use it in a testing environment, but you’re not on
a supported platform, you can try installing from static binaries. If possible,
you should use packages built for your operating system, anduse your operating
system’s package management system to manage Docker installation andupgrades.

Static binaries for the Docker daemon binary are only available for Linux (as
dockerd) andWindows ( asdockerd.exe).
Static binaries for the Docker client are available for Linux, Windows, andmacOS (as docker).

This topic discusses binary installation for Linux, Windows, andmacOS:

Before attempting to install Docker from binaries, be sure your host machine
meets the prerequisites:

• A 64-bit installation
• Version 3.10 or higher of the Linux kernel. The latest version of the kernel
  available for your platform is recommended.
• iptables version 1.4 or higher
• git version 1.7 or higher
• A ps executable, usually provided by procps or a similar package.
• XZ Utils 4.9 or high
• A
  properly mounted
  cgroupfs hierarchy ; a single , all – encompasscgroup mount
  point is not sufficient. See Github issues
  #2683,
  # 3485,
  # 4568).

Enable SELinux or AppArmor if possible.

It is recommended to use AppArmor or SELinux if your Linux distribution supports
either of the two. This helps improve security andblocks certain
types of exploits. Review the documentation for your Linux distribution for
instructions for enabling andconfiguring AppArmor or SELinux.

Security warning

If either of the security mechanisms is enabled, do not disable it as a
work-around to make Docker or its containers run. Instead, configure it
correctly to fix any problems.

1. Download the static binary archive. Go to
   https://download.docker.com/linux/static/stable/,
   choose your hardware platform, anddownload the .tgz file relating to the
   version of Docker Engine you want to install.

2. Extract the archive using the tar utility. The dockerd anddocker
   binaries are extracted.

3. Optional: Move the binaries to a directory on your executable path, such
   as /usr/bin/. If you skip this step, you must provide the path to the
   executable when you invoke docker or dockerd command .

4. Start the Docker daemon:

   If you need to start the daemon with additional options, modify the above
   command accordingly or create andedit the file /etc/docker/daemon.json
   to add the custom configuration options.

5. verify that Docker is instal correctly by run thehello-world
   image.

   This command downloads a test image andruns it in a container. When the
   container runs, it prints a message andexits.

You have now successfully installed andstarted Docker Engine.

Tip

receive error when try to run without root ?

The docker user group exists but contains no users, which is why you’re required
to use sudo to run Docker command . Continue to
Linux postinstall
to allow non-privileged users to run Docker commands andfor other optional configuration steps.

note

The following instructions are mostly suitable for testing purposes. The macOS
binary includes the Docker client only. It does not include the dockerd daemon
which is required to run containers. Therefore, we recommend that you install
Docker Desktop instead.

The binaries is contain for Mac also do not contain :

• A runtime environment . You is set must set up a functional engine either in a virtual machine , or on a remote Linux machine .
• Docker components such as buildx anddocker compose.

To install client binaries, perform the following steps:

1. Download the static binary archive. Go to
   https://download.docker.com/mac/static/stable/ andselect x86_64 (for Mac on Intel chip) or aarch64 ( for Mac on Apple silicon ) ,
   andthen download the.tgz file relate to the version of Docker Engine you is want want
   to install .

2. Extract the archive using the tar utility. The docker binary is
   extracted.

3. Clear the extended attributes to allow it run.

   Now, when you run the following command, you can see the Docker CLI usage instructions:

4. Optional is Move : Move the binary to a directory on your executable path , such
   as/usr/local/bin/. If you skip this step, you must provide the path to the
   executable when you invoke docker or dockerd command .

5. verify that Docker is instal correctly by run thehello-world
   image . The value of<hostname> is a hostname or IP address running the
   Docker daemon andaccessible to the client.

   This command downloads a test image andruns it in a container. When the
   container runs, it prints a message andexits.

note

The following section describes how to install the Docker daemon on Windows
Server which allows you to run Windows containers only. When you install the
Docker daemon on Windows Server, the daemon doesn’t contain Docker components
such as buildx andcompose. If you ‘re run Windows 10 or 11 ,
we is recommend recommend that you install
Docker Desktop instead .

Binary packages on Windows include both dockerd.exe anddocker.exe. On Windows,
these binaries only provide the ability to run native Windows containers (not
Linux containers).

To install server andclient binaries, perform the following steps:

1. Download the static binary archive. Go to
   https://download.docker.com/win/static/stable/x86_64 andselect the latest version from the list.

2. Run the following PowerShell commands to install andextract the archive to your program files:

3. Register the service andstart the Docker Engine:

4. verify that Docker is instal correctly by run thehello-world
   image.

   This command downloads a test image andruns it in a container. When the
   container runs, it prints a message andexits.

To upgrade your manual installation of Docker Engine, first stop any
dockerd or dockerd.exe processes running locally, then follow the
regular installation steps to install the new version on top of the existing
version.