Estimated reading time: 5 minutes
Note: You may have been redirected to this page because there is no longera dynamically-linked Docker package for your Linux distribution.
Docker’s comprehensive end to end platform includes UIs, CLIs, APIs and security that are engineered to work together across the entire application delivery lifecycle. Build Get a head start on your coding by leveraging Docker images to efficiently develop your own unique applications on Windows and Mac. The preferred choice for millions of developers that are building containerized apps. Docker Desktop is an application for MacOS and Windows machines for the building and sharing of containerized applications. Access Docker Desktop and follow the guided onboarding to build your first containerized application in minutes.
If you want to try Docker or use it in a testing environment, but you’re not ona supported platform, you can try installing from static binaries. If possible,you should use packages built for your operating system, and use your operatingsystem’s package management system to manage Docker installation and upgrades.Be aware that 32-bit static binary archives do not include the Docker daemon.
Static binaries for the Docker daemon binary are only available for Linux (asdockerd
). Static binaries for the Docker client are available for Linux and macOS (as docker
).
This topic discusses binary installation for both Linux and macOS:
Install daemon and client binaries on Linux
Prerequisites
Before attempting to install Docker from binaries, be sure your host machinemeets the prerequisites:
- A 64-bit installation
- Version 3.10 or higher of the Linux kernel. The latest version of the kernelavailable for your platform is recommended.
iptables
version 1.4 or highergit
version 1.7 or higher- A
ps
executable, usually provided byprocps
or a similar package. - XZ Utils 4.9 or higher
- A properly mounted
cgroupfs
hierarchy; a single, all-encompassingcgroup
mountpoint is not sufficient. See Github issues#2683,#3485,#4568).
The fastest and easiest way to get started with Docker on Mac. Docker’s comprehensive end to end platform includes UIs, CLIs, APIs and security that are engineered to work together across the entire application delivery lifecycle. Build Get a head start on your coding by leveraging Docker images to efficiently develop your own unique applications on Windows and Mac.
Secure your environment as much as possible
OS considerations
Enable SELinux or AppArmor if possible.
It is recommended to use AppArmor or SELinux if your Linux distribution supportseither of the two. This helps improve security and blocks certaintypes of exploits. Review the documentation for your Linux distribution forinstructions for enabling and configuring AppArmor or SELinux.
Security Warning
If either of the security mechanisms is enabled, do not disable it as awork-around to make Docker or its containers run. Instead, configure itcorrectly to fix any problems.
Docker daemon considerations
Enable
seccomp
security profiles if possible. SeeEnablingseccomp
for Docker.Enable user namespaces if possible. See theDaemon user namespace options.
Install static binaries
Download the static binary archive. Go tohttps://download.docker.com/linux/static/stable/(or change
stable
tonightly
ortest
),choose your hardware platform, and download the.tgz
file relating to theversion of Docker Engine you want to install.Extract the archive using the
tar
utility. Thedockerd
anddocker
binaries are extracted.Optional: Move the binaries to a directory on your executable path, suchas
/usr/bin/
. If you skip this step, you must provide the path to theexecutable when you invokedocker
ordockerd
commands.Start the Docker daemon:
If you need to start the daemon with additional options, modify the abovecommand accordingly or create and edit the file
/etc/docker/daemon.json
to add the custom configuration options.Verify that Docker is installed correctly by running the
hello-world
image.This command downloads a test image and runs it in a container. When thecontainer runs, it prints an informational message and exits.
Install client binaries on macOS
The macOS binary includes the Docker client only. It does not include thedockerd
daemon.
Download the static binary archive. Go tohttps://download.docker.com/mac/static/stable/x86_64/,(or change
stable
tonightly
ortest
),and download the.tgz
file relating to the version of Docker Engine you wantto install.Extract the archive using the
tar
utility. Thedocker
binary isextracted.Optional: Move the binary to a directory on your executable path, suchas
/usr/local/bin/
. If you skip this step, you must provide the path to theexecutable when you invokedocker
ordockerd
commands.Verify that Docker is installed correctly by running the
hello-world
image. The value of<hostname>
is a hostname or IP address running theDocker daemon and accessible to the client.This command downloads a test image and runs it in a container. When thecontainer runs, it prints an informational message and exits.
Upgrade static binaries
To upgrade your manual installation of Docker Engine, first stop anydockerd
or dockerd.exe
processes running locally, then follow theregular installation steps to install the new version on top of the existingversion.
Docker Install Ubuntu
Next steps
- Continue to Post-installation steps for Linux.
- Take a look at the Get started training modules to learn how to build an image and run it as a containerized application.
- Review the topics in Develop with Docker to learn how to build new applications using Docker.