Ready to get started with Docker on Ubuntu? This guide will provide you with all the information you need to successfully install and set up Docker on your system.
If you did not already know, Docker is the heart of my home server. Previously, I used to install all my home server apps directly on my server.
Needless to say, this was cumbersome and docker has revolutionized the way applications are deployed worldwide.
While most of our guides published previously include brief instructions, due to the importance of this topic, I decided to write a dedicated guide to install Docker on Ubuntu and Debian based Linux distributions.
Docker, also known as Docker Engine, is an open-source containerization technology for applications. It allows users to install applications inside software containers.
What this means is that applications can be separated/isolated from the operating system on which they are running.
But isn't this what Virtualization does? Yes, but there are differences.
In Docker containers, each application is self-contained, therefore setup and removal is easy and has little to no effect on the operating system.
With several HTPC and home server apps already available for easy installation as containers, on Docker Hub, this is the new way to setup your home server quickly.
Add to this, the features of Docker Compose (more on this later), starting up and down your stack and migrating it becomes so much easier.
Install Docker on Ubuntu 22.04
Note that in this tutorial, all commands are being run as the user (anand). If you are logged in as root, you can drop the sudo in front of the commands.
Now that you know what Docker is, let us learn how to install Docker on Ubuntu and Debian Linux.
Install Docker on Ubuntu (with Compose) - Don't Do It WRONG
There are many ways to setup Docker on Debian systems. First, I am going to show you the best and the recommended way.
Note that the "Best" way for Ubuntu docker installation does not mean the "fastest" or the "easiest". It means, the best way to install it for long-term benefit (i.e. faster updates, security patches, etc.).
Even though the Ubuntu Docker installation method that I recommed should be enough, I will list some of the other methods for informational purposes.
Pre-Requisites for Docker Ubuntu Setup
Before you begin, you must enable hardware virtualization. This refers to VT-x on Intel and AMD-V on AMD motherboards. This is required for Docker to run.
While installing Docker Engine from Ubuntu repositories is easier, adding official docker repository gives you faster updates. Hence why this is the recommended method.
First, let us get the GPG key which is needed to connect to the Docker repository. To that, use the following command.
Note: If you use curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - as in some older guides, you see the following message - Warning: apt-key is deprecated. Manage keyring files in trusted.gpg.d instead.
Next, add the repository to the sources list. While you can also add it manually, the command below will do it automatically for you.
The above command will automatically fill in your release code name (jammy for 22.04, focal for 20.04, and bionic for 18.04).
Finally, refresh your packages again.
sudo apt update
If you forget to add the GPG key, then the above step would fail with an error message. Otherwise, let us get on with installing Docker on Ubuntu.
Step 3: Install Docker on Ubuntu/Debian Linux
What is the difference between docker.io and docker-ce?
docker.io is the docker package that is offered by some popular Linux distributions (e.g. Ubuntu/Debian). docker-ce on the other hand, is the docker package from official Docker repository. Typically docker-ce more up-to-date and preferred.
In this Ubuntu Docker setup guide, we will install the docker-ce (and not docker.io package).
To install Docker on Ubuntu or Debian, use the following command:
sudo apt install docker-ce
This will download and install several hundrend MBs of packages, as shown below.
Install Docker On Ubuntu Server 22.04 Jammy Jellyfish
Continue and the docker engine installation process should normally go through without any issues.
Step 4: Verify that Docker is Running on Ubuntu
There are many ways to check if Docker is running on Ubuntu. One way is to use the following command:
sudo systemctl status docker
You should see an output that says active for status.
Check If Docker Is Running On Ubuntu
The next way is to use sudo docker ps -a command, which will show you the running containers. There should be nothing at this point but the command should still return a blank list.
List Of Active Docker Containers
The example above shows the error that is output when docker is not running. Then we start docker and rerun the command to see a blank list of containers.
The last yet the official way to check if Docker is running is to actually start a container and check. The most famous one is "hello-world".
Check If Docker Is Running Using Hello World
The above command downloads and runs the hello-world test container and if successful, prints a message, and exits as shown above.
If the tests pass then you are good to go. You now have Docker installed on Ubuntu.
Be the 1 in 200,000. Help us sustain what we do.
125/150 by Dec 31, 2024
You will gain benefits such as Deployarr access, discord roles, exclusive content, ad-free browsing, and more.
Docker Compose is an additional piece of software that takes Docker to the next level.
Compose allows you to create a list of services/containers and their configuration in YAML. Once done, you can create, start, and stop all of your containers with one command.
Unfortunately, Docker Compose is not automatically installed with Docker. Although it is included in repositories of most Linux distributions, as with Docker, the version is probably not current.
So let us see how to install Docker Compose on Ubuntu and Debian Linux systems.
Step 1: Check the Current Version of Docker Compose
As said before, the version of docker-compose packaged with the Linux distribution is probably old.
Verion Of Docker Compose In Ubuntu Jammy Repo
Checking the releases on Docker Compose GitHub, the last release is v2.4.1. So the Ubuntu repo version (1.29.2) in the screenshot above is at least several versions old.
Step 2: Install Docker Compose on Ubuntu
Unlike Docker, there are no official repositories that you can add to easily install Docker Compose on Ubuntu.
You will have to manually download and install it. But fear not, it is quite easy.
First, download the latest version of Docker Compose using the following command:
Download the stable file from pool->stable for your architecture (normally amd64) and run sudo dpkg -i package-name.deb from the same directory as the downloaded .deb file.
This should install Docker as well. However, you will have to manually download and install each update the same way. Therefore, I wouldn't recommend this method either.
Using Installer Script
There is a script that can basically do all the steps listed in the recommended method. Download the script using the following command:
Although in this case it is probably OK (trusted source), running a one line script is never recommended. In addition, this script assumes all default options (e.g. cannot pick a custom version).
Therefore, I do not recommend using the Docker installer script as well. Plus, the steps described above are not complex to follow.
Basic Docker and Docker-Compose Commands
Now that you have both Docker and Docker Compose installed, let us look at some basic usage.
There are numerous docker and docker compose commands and covering them all is not the purpose of this post. You can see all possible commands using the following command:
docker
But, here are few docker and docker compose commands to get started:
Note: If you are using the new Docker Compose V2, which is installed as a docker plugin, then use docker compose instead of docker-compose (without hyphen).
sudo docker info - Information on your docker installation.
sudo docker search IMAGE_NAME - Search for specific images/containers.
sudo docker start CONTAINER_NAME - Start one or more containers.
sudo docker stop CONTAINER_NAME - Stop one or more containers.
sudo docker restart CONTAINER_NAME - Restart one or more containers.
sudo docker top CONTAINER_NAME - See running processes of a container.
sudo docker rm CONTAINER_NAME - Remove one or more containers.
sudo docker network ls - See all defined docker networks.
sudo docker ps -a - See all running containers.
sudo docker logs CONTAINER_NAME - See logs of a one, more, or all containers.
sudo docker-compose up -d CONTAINER_NAME - Start specific or all services defined in docker-compose.yml.
sudo docker-compose down CONTAINER_NAME - Stop specific or all services defined in docker-compose.yml.
Note that in most cases CONTAINER_NAME is optional and the command applies to all possible containers if no container name is specified.
There are several more cool commands I use, but it is best that I refer you to my bash aliases that lists all the commands I use frequently in my Ubuntu docker environment.
Tips to Enchance Docker Experience
1. Setup Bash Aliases to Simplify Commands
If you have no clue what I am talking about, then I suggest you to read our Bash Aliases guide for a general idea.
With bash aliases set, you can run several docker and docker compose commands using shortcuts (instead of the full commands listed above). For example, just dps (or whatever you set) instead of sudo docker ps -a.
For a list of all bash aliases I currently use to help manage my Docker home server, check out my GitHub repo.
2. Add User to Docker Group
I personally do not do or recommend this. All my bash aliases have sudo added where required and I elevate my privileges when required. But if you prefer the convenience of not having to use sudo for Docker commands then you may choose to implement it.
Running and managing docker containers requires sudo privileges. So this means you will have to type sudo for every command or switch to the root user account. But you can get around this by adding the current user to the docker group using the following command:
sudo usermod -aG docker ${USER}
You can replace ${USER} with your user name or just run the command as-is while you are logged in.
While this can be a minor security risk, it should be OK as long as other Docker security measures are in place.
3. Securing Docker
If not implemented properly, there are several places where you can leave a security hole for the intruder to get in.
I suggest that you review the security practices linked above to ensure that your Docker setup on Ubuntu is well protected.
FAQs
How do autostart Docker on Boot?
If you followed the method recommended above, Docker should autostart on Ubuntu during boot. Nothing more is needed. However, in case of any issues or if you want to force it anyway, use sudo systemctl enable docker.
Does Docker run on Ubuntu?
Yes, Docker does run very well on Ubuntu, Debian, and other Linux distributions. On Mac and Windows, there is Docker Destop.
Is Docker the same as Docker Desktop?
No, Docker and Docker Desktop are different products. Docker Desktop includes Docker Engine and is designed to enable Mac and Windows systems to build, share, and run Docker containers. Having said that, Docker Desktop Ubuntu and for other Linux distributions will be available soon (currently in Beta).
Concluding Remarks
So there you have it, detailed information on how to install Docker and Docker Compose on Ubuntu 22.04 LTS Jammy Jellyfish and additional information to take your installation to the next well.
Anand is a self-learned computer enthusiast, hopeless tinkerer (if it ain't broke, fix it), a part-time blogger, and a Scientist during the day. He has been blogging since 2010 on Linux, Ubuntu, Home/Media/File Servers, Smart Home Automation, and related HOW-TOs.
