Let’s Dock! Docker GUI with Portainer

How to Install the Docker GUI and Management Tool Portainer on Raspberry Pi OS

Have you ever wanted a GUI for Docker, but Kubernetes is a bit too much for your needs? Portainer might be the Solution you are looking for. Let’s install Portainer from Scratch on an fresh installed Raspberry Pi…

Requirements

OS Installation

This Tutorial is based on a Raspberry Pi OS (bullseye) Installation (64 Bit). It should work also on other Linux Distributions.

Get the Raspberry PI OS Lite Image from here: https://www.raspberrypi.com/software/operating-systems/

Advertisements

Flash the OS onto you SD Card – I used Balena Etcher to do so.

Now it’s Time to do the Software Installation / Configuration. Put the SD Card into your Raspberry and fire it up. 

System Configuration

Login to your Raspberry – Username: “pi” and Password: “raspberry”. We’ll do some basic Configurations now: 

sudo raspi-config

Timezone and Keyboard Configuration

Go to Menu “5 Localisation”, Submenu

  • “L1 Locale” and set at least your default locale
  • “L2 Timezone” and configure your Timezone
  • “L3 Keyboard” and configure your Keyboard Layout

Exit “raspi-config” and check your “locale” Settings

sudo nano -w /etc/default/locale

Your file should look like:

File generated by update-locale
LANG=en_US.UTF-8
LC_CTYPE=en_US.UTF-8
LC_MESSAGES=en_US.UTF-8
LC_ALL=en_US.UTF-8

If the last 3 lines are missing, add and customise them depending on your “LANG=” Setting. 

Reboot your Pi now!

Network Configuration

sudo raspi-config

Go to Menu “1 System Options”, Submenu 

  • “S1 Wireless LAN” and configure your Wifi
  • “S4 Hostname” and setup a nice Name for your Frame

Exit the Setup and reboot if asked the Pi now. Also you can reboot with:

sudo reboot

Login to your Pi and test if your Internet Connection is working. 

ping www.google.de

Optional: I recommend to activate SSH to continue remote with the Setup, you can enable it by typing

sudo systemctl enable ssh
sudo systemctl start ssh

Software Installation

We’ll update our System first:

sudo apt-get update
sudo apt-get upgrade

Time synchronisation

It’s always a good idea to keep Date and Time in sync – We install “Chrony” to do so:

sudo apt install chrony
sudo systemctl enable chrony
sudo systemctl start chrony

Check if date and Time is correct:

date

Docker Installation

Install Docker directly from docker.com by entering:

curl -sSL https://get.docker.com | sh

Finally add your current User to the Docker Group

sudo usermod -aG docker pi

You need now to logoff and logon again, to get the new Group Assignment:

exit

Logon again – Check if Docker is working:

docker run hello-world

If everything is working, Docker will grab the “hello-world:latest” Image and Display

“Hello from Docker!”

with some additional Information.

Portainer Installation

Portainer is shipped as Docker Image – so it’s easy to install it from Docker Hub by typing:

sudo docker pull portainer/portainer-ce:latest

Now we are ready to start Portainer. 

sudo docker run -d -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

Portainer is now available at your Raspberry Pi IP followed by Port 9000.

Open the Browser of you choice and enter http:// followed by the Raspberry Pi IP and “:” Port Number 9000. Note – Portainer is not available on https at this State. You should see the Setup Landing-Page now. Create the admin User by setting up the Password.

Portainer Configuration

After you signed into the Administration Panel, click on “Get Started” to use the local environment, which we just installed.

You are now ready to manage your Docker environment with Portainer.

Congratulations – You successfully installed Portainer. You may be interested in how to setup your first Container now. So just have a look at our related Articles:

*Amazon Affiliate Link