Easily manage your Docker containers with Portainer on Raspberry Pi

A step-by-step guide to install and configure Portainer, a powerful tool for managing Docker containers on Raspberry Pi. …

Updated August 5, 2023

A step-by-step guide to install and configure Portainer, a powerful tool for managing Docker containers on Raspberry Pi. Portainer is an open-source software that allows users to easily manage their Docker containers from a single interface. It provides features like container management, image management, network management, volume management, and more. In this article, we will show you how to install Portainer on Raspberry Pi and configure it to work with your existing Docker setup.

Prerequisites

Before you begin, make sure you have the following:

A Raspberry Pi running Raspbian OS or any other Linux distribution
Docker installed on your Raspberry Pi
Basic knowledge of Docker and command line interface (CLI)

Step 1: Install Portainer

The first step is to download the Portainer executable file from the official GitHub repository. You can do this by running the following command in your terminal:

curl -L https://downloads.portainer.io/portainer-agent-stack.tar.gz -o portainer-agent-stack.tar.gz

Once downloaded, extract the contents of the archive using:

tar xvzf portainer-agent-stack.tar.gz

Now you need to deploy the Portainer stack by running the following command:

docker compose up -d

This will start Portainer and deploy it as a Docker container in your system.

Step 2: Access Portainer

To access the Portainer web interface, open your browser and go to http://<raspberry-pi-ip>:90000. Replace <raspberry-pi-ip> with the IP address of your Raspberry Pi. You should see the Portainer login page. The default username is admin and password is password.

Step 3: Configure Docker endpoint

Once logged in, you need to add your Docker environment as an endpoint. To do this, click on the “Local” endpoint and then click on “Connect”. This will connect Portainer to the Docker daemon running on your Raspberry Pi. You can now manage all your containers and images from the web interface.

Step 4: Create an admin user

It’s recommended to change the default admin username and password for security reasons. To do this, click on the “Users” tab in the left menu and then click on “+ Add User”. Fill out the required fields and set the role as “Administrator”. Once created, you can use this user to log in to Portainer.