How to Install Portainer Docker UI Manager on Ubuntu 18.04 | 16.04

This post shows students and new users how to install Portainer Docker management tool on Ubuntu 18.04 | 16.04.

Portainer is a powerful, open-source management toolset that allows you to easily build, manage and maintain Docker environments. It support Windows, Linux and Mac OS.

With Portainer, you can quickly deploy applications from app templates, manage Docker containers, manage volumes and many more.

If you’re looking for a simple to use Docket management tool that is also open source, Portainer is a great place to start.

For more about Portainer, please check its homepage.

To get started with installing Portainer on Ubuntu, follow the steps below:

Step 1: Install Docker and Docker Compose

Docker has two editions:  The Enterprise Edition (EE) and the Community Edition (CE).

For this tutorial, we’re going to be installing the community edition of Docker..

If you always want to automatically get the latest version of Docker on Ubuntu, you must add its official repository to Ubuntu system.. To do that, run the commands below to install prerequisite packages…

sudo apt update
sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

Next, run the commands below to download and install Docker’s official GPG key.. The key is used to validate packages installed from Docker’s repository making sure they’re trusted..

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo apt-key fingerprint 0EBFCD88

You should see an output shown below:

Output:
pub   rsa4096 2017-02-22 [SCEA]
      9DC8 5822 9FC7 DD38 854A  E2D8 8D81 803C 0EBF CD88
uid           [ unknown] Docker Release (CE deb) <docker@docker.com>
sub   rsa4096 2017-02-22 [S]

Now that the official GPG key is installed, run the commands below to add its stable repository to Ubuntu… To add the nightly or test repository, add the word nightly or test (or both) after the word stable in the commands below…

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

At this point, Docker’s official GPG and repository should be installed on Ubuntu…

For those who currently have older versions of Docker, run the commands below to remove them…

sudo apt-get remove docker docker-engine docker.io containerd runc

When you have remove all previous versions of Docker, run the commands below to install the latest and current stable version of Docker…

To install specific version of Docker, run the apt-cache command…Then select the version to install..

apt-cache madison docker-ce

Output:
docker-ce | 5:18.09.5~3-0~ubuntu-bionic | https://download.docker.com/linux/ubuntu bionic/stable amd64 Packages
docker-ce | 5:18.09.4~3-0~ubuntu-bionic | https://download.docker.com/linux/ubuntu bionic/stable amd64 Packages
docker-ce | 5:18.09.3~3-0~ubuntu-bionic | https://download.docker.com/linux/ubuntu bionic/stable amd64 Packages
docker-ce | 5:18.09.2~3-0~ubuntu-bionic | https://download.docker.com/linux/ubuntu bionic/stable amd64 Packages
....

Now to install a specific version, run the commands below with the version you wish to install

sudo apt-get install docker-ce=5:18.09.5~3-0~ubuntu-bionic docker-ce-cli=5:18.09.5~3-0~ubuntu-bionic containerd.io

If you just want to latest version without specifying above, run the commands below… The command below will always install the highest possible version…

sudo apt update
sudo apt-get install docker-ce docker-ce-cli containerd.io

That should install Docker software on Ubuntu.

Add your account to Docker group and restart.

sudo usermod -aG docker $USER
sudo reboot

Verify that Docker CE is installed correctly by running the hello-world image, run the commands below:

sudo docker run hello-world

You should see a similar lines as below:

Output:
Hello from Docker!
This message shows that your installation appears to be working correctly.

Docker is installed correctly!

Install Docker Compose

On Ubuntu Linux, you can download the Docker Compose binary from the Compose repository release page on GitHub….

To install it, run the commands below to download version 1.24.0… As of this writing this was the current version…

sudo curl -L "https://github.com/docker/compose/releases/download/1.24.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

To install a different version of Compose, substitute 1.24.0 with the version of Compose you want to use.

After downloading it, run the commands below to apply executable permissions to the binary file and create a symbolic link to /usr/binary

sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

That should get Docker Compose working… To test, run the commands below:

docker-compose --version

You should see similar output as below:

Output:
docker-compose version 1.24.0, build 0aa59064

Step 2: Setup Portainer

Now that Docker and Docker Composer are installed, follow the steps below to get Portainer setup.

You can use Docker command to deploy the Portainer Server; note the agent is not needed on standalone hosts, however it does provide additional functionality if used.

To get the server installed, run the commands below.

cd ~/
docker volume create portainer_data
docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer

You’ll just need to access the port 9000 of the Docker engine where portainer is running using your browser.

Note: the -v /var/run/docker.sock:/var/run/docker.sock option can be used in Linux environments only.

After a successful pull, you should get similar message as below:

latest: Pulling from portainer/portainer
d1e017099d17: Pull complete 
a7dca5b5a9e8: Pull complete 
Digest: sha256:4ae7f14330b56ffc8728e63d355bc4bc7381417fa45ba0597e5dd32682901080
Status: Downloaded newer image for portainer/portainer:latest
2fd5f4a0883a9d358ad424fd963699445be8839f3e6a2cf73d55778bcc268523

Step 3: Access Portainer Portal

At this point, all you need to do is access Portainer portal to manage Docker. Open your web browser and browse to the server’s hostname or IP address followed by port #9000

http://localhost:9000

You should get Portainer login page to create an admin password.

Portainer Ubuntu Install

Create a password and continue.

Portainer Ubuntu Install

Since we installed Docker on the same machine, select to connect and manage Docker locally.

Portainer Ubuntu Install

You’ll be directed to Portainer dashboard where you can start managing Docker. Browse around and begin setting up your environment. If you had Docker installed on a remote computer, you’ll have to install Portainer agent on the server.

For more about that, check this link below:

That’s it!

Conclusion:

This post showed you how to install Portainer Docker manager on Ubuntu 18.04 | 16.04. If you find any error above, please use the comment form below to report.

Thanks,

You may also like the post below:

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.