67 lines
2.5 KiB
Markdown
67 lines
2.5 KiB
Markdown
|
||
|
||
[Ubuntu \| Docker Docs](https://docs.docker.com/engine/install/ubuntu/)
|
||
|
||
### [Install using the `apt` repository](https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository)
|
||
|
||
Before you install Docker Engine for the first time on a new host machine, you need to set up the Docker `apt` repository. Afterward, you can install and update Docker from the repository.
|
||
|
||
1. Set up Docker's `apt` repository.
|
||
|
||
```bash
|
||
# Add Docker's official GPG key:
|
||
sudo apt-get update
|
||
sudo apt-get install ca-certificates curl
|
||
sudo install -m 0755 -d /etc/apt/keyrings
|
||
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
|
||
sudo chmod a+r /etc/apt/keyrings/docker.asc
|
||
|
||
# Add the repository to Apt sources:
|
||
echo \
|
||
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
|
||
$(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
|
||
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
|
||
sudo apt-get update
|
||
```
|
||
|
||
2. Install the Docker packages.
|
||
|
||
Latest Specific version
|
||
|
||
---
|
||
|
||
To install the latest version, run:
|
||
|
||
```console
|
||
$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
|
||
```
|
||
|
||
---
|
||
|
||
3. Verify that the installation is successful by running the `hello-world` image:
|
||
|
||
```console
|
||
$ sudo docker run hello-world
|
||
```
|
||
|
||
This command downloads a test image and runs it in a container. When the container runs, it prints a confirmation message and exits.
|
||
|
||
|
||
You have now successfully installed and started Docker Engine.
|
||
|
||
> **Tip**
|
||
>
|
||
> Receiving errors when trying 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 commands. Continue to [Linux postinstall](https://docs.docker.com/engine/install/linux-postinstall) to allow non-privileged users to run Docker commands and for other optional configuration steps.
|
||
|
||
#### [Upgrade Docker Engine](https://docs.docker.com/engine/install/ubuntu/#upgrade-docker-engine)
|
||
|
||
To upgrade Docker Engine, follow step 2 of the [installation instructions](https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository), choosing the new version you want to install.
|
||
|
||
|
||
### Install Portainer
|
||
|
||
[Install Portainer CE with Docker on Linux \| Portainer Documentation](https://docs.portainer.io/start/install-ce/server/docker/linux)
|
||
|