Install Portainer Docker GUI on Debian 12 | Powerful Tool

This tutorial is designed to guide you through the process of installing Install Portainer Docker GUI on Debian 12. Portainer offers a user-friendly graphical interface for managing your Docker containers, making it an excellent alternative for those who prefer a visual approach over the command-line interface. Follow the steps outlined in this guide, brought to you by Orcacore, to successfully Install Portainer Docker GUI on Debian 12.

Before diving into the installation, let’s ensure you have the necessary prerequisites in place.

Requirements for Portainer Installation

To successfully Install Portainer Docker GUI on Debian 12, you’ll need the following:

Server Access: You should be logged in to your Debian 12 server as a root user or a non-root user with sudo privileges. If you haven’t already configured this, you can follow the Orcacore guide on Initial Server Setup with Debian 12 Bookworm.
Docker CE Installation: Docker CE must be installed on your server. Refer to the Orcacore guide on Install Docker CE on Debian 12 Bookworm for detailed instructions.
Docker Compose Installation: Docker Compose needs to be installed on your server. You can follow the Orcacore guide on Install Docker Compose on Debian 12 Bookworm.

Once you’ve met these requirements, you’re ready to proceed with the installation of Portainer.

Step 1. Install Portainer on Debian 12

With the prerequisites taken care of, you can now begin the process to Install Portainer Docker GUI on Debian 12.

Create Docker Volume For Portainer

First, create a Docker volume to store Portainer data. Docker volumes are file systems mounted on Docker containers to preserve data generated by the running container. To do this, run the following command:

docker volume create data

Verify the volume creation with the following command:

docker volume ls

**Output**
DRIVER    VOLUME NAME
local     data

Download and Run Portainer Docker Image

Now, download and run the Portainer Docker image using the following command:

docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v data:/data portainer/portainer

**Output**
latest: Pulling from portainer/portainer
772227786281: Pull complete
96fd13befc87: Pull complete
0bad1d247b5b: Pull complete
b5d1b01b1d39: Pull complete
Digest: sha256:47b064434edf437badf7337e516e07f64477485c8ecc663ddabbe824b20c672d
Status: Downloaded newer image for portainer/portainer:latest
1dccea07ea208064bef4bac26ba2b20c35436ea2b062e530c226fb19c2831565

Check the status of your Portainer container using the following command:

docker ps

**Output**
CONTAINER ID   IMAGE                 COMMAND        CREATED          STATUS          PORTS                                                                                            NAMES
1dccea07ea20   portainer/portainer   "/portainer"   18 seconds ago   Up 17 seconds   0.0.0.0:8000->8000/tcp, :::8000->8000/tcp, 0.0.0.0:9000->9000/tcp, :::9000->9000/tcp, 9443/tcp   portainer

Step 2. Access Portainer Dashboard on Debian 12

At this point, Portainer is running on port 9000. Access the web interface by typing your server’s IP address in your web browser followed by :9000:

http://your-server-ip:9000

On the initial screen, create the administrator user.

You will then see the Portainer dashboard.

You can now easily host your application on the containerization platform via a web-based interface.

For more information, visit the Portainer Docs page.

Conclusion

You have successfully learned to Install Portainer Docker GUI on Debian 12 and access the dashboard. As demonstrated, it is a valuable tool for those who prefer managing their Docker containers through a graphical interface. Now you can easily Install Portainer Docker GUI on Debian 12 following this guide.

Also, you may be interested in these articles:

We hope you enjoyed this tutorial. Please subscribe to us on Facebook, Instagram, and Twitter.

Alternative Solutions to Installing Portainer on Debian 12

While the provided method effectively installs Portainer, let’s explore two alternative approaches that offer different benefits and cater to varying needs. These alternative solutions can help you to Install Portainer Docker GUI on Debian 12 in ways that might be better suited for your workflow.

1. Deploying Portainer using Docker Compose

Docker Compose allows you to define and manage multi-container Docker applications. Using a docker-compose.yml file simplifies the deployment process and makes it repeatable.

Explanation:

This method involves creating a docker-compose.yml file that specifies the Portainer service, its dependencies (such as the Docker socket and the data volume), and its configuration. This approach is beneficial because it allows you to define your application’s entire stack in a single file, making it easier to manage and deploy.

Steps:

Create a docker-compose.yml file:

Create a file named docker-compose.yml in a directory of your choice (e.g., /opt/portainer).
Edit the docker-compose.yml file:

Add the following content to the docker-compose.yml file:
```
version: "3.9"
services:
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    restart: always
    ports:
      - "8000:8000"
      - "9000:9000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data

volumes:
  portainer_data:
```
Explanation of the docker-compose.yml file:
- version: "3.9": Specifies the version of the Docker Compose file format.
- services: Defines the services that make up the application. In this case, it’s just the portainer service.
- image: portainer/portainer-ce:latest: Specifies the Docker image to use for the Portainer service. Using latest is not recommended for production. It is better to define a specific version.
- container_name: portainer: Assigns a name to the container.
- restart: always: Ensures that the container restarts automatically if it fails.
- ports: Maps the container’s ports to the host’s ports.
- volumes: Defines the volumes to be mounted into the container. /var/run/docker.sock allows Portainer to communicate with the Docker daemon, and portainer_data is a named volume for storing Portainer data.
- volumes: section at the bottom defines the named volume portainer_data.
Deploy Portainer using Docker Compose:

Navigate to the directory containing the docker-compose.yml file and run the following command:
```
docker-compose up -d
```
This command will download the Portainer image (if it’s not already present), create the necessary volumes, and start the Portainer container in detached mode (-d).
Verify the Deployment:

You can check the status of the Portainer container using the following command:
```
docker ps
```
This will show you the running containers, including Portainer.

This method simplifies the installation and management of Portainer, especially when dealing with more complex setups involving multiple containers.

2. Using Ansible to Automate Portainer Installation

Ansible is an open-source automation tool that can be used to provision and configure systems. Using Ansible, you can automate the installation of Docker, Docker Compose, and Portainer, ensuring consistency and repeatability across multiple servers.

Explanation:

This method involves creating an Ansible playbook that defines the tasks required to install Portainer. The playbook will handle installing the necessary dependencies (Docker and Docker Compose), creating the Docker volume, and deploying the Portainer container. This approach is ideal for managing multiple servers or when you need to ensure consistent configurations across your infrastructure.

Steps:

Install Ansible:

If you don’t already have Ansible installed, you can install it using pip:
```
pip install ansible
```

Create an Ansible Playbook:

Create a file named portainer_install.yml (or any name you prefer) with the following content:

---
- hosts: all
  become: true
  tasks:
    - name: Install Docker CE
      apt:
        name: docker.io
        state: present

    - name: Install Python3-pip
      apt:
        name: python3-pip
        state: present

    - name: Install Docker Module for Python
      pip:
        name: docker
        state: present

    - name: Install Docker Compose
      apt:
        name: docker-compose-plugin
        state: present

    - name: Create Docker Volume for Portainer
      command: docker volume create data
      ignore_errors: yes

    - name: Run Portainer Docker Container
      docker_container:
        name: portainer
        image: portainer/portainer-ce:latest
        state: started
        restart_policy: always
        ports:
          - "8000:8000"
          - "9000:9000"
        volumes:
          - /var/run/docker.sock:/var/run/docker.sock
          - data:/data

Explanation of the Ansible Playbook:

hosts: all: Specifies that the playbook should run on all hosts defined in your Ansible inventory.
become: true: Enables privilege escalation (sudo) for the tasks.
tasks: Defines the list of tasks to be executed.
- Install Docker CE: Installs Docker CE using the apt module.
- Install Docker Compose: Installs Docker Compose using the apt module.
- Create Docker Volume for Portainer: Creates the Docker volume using the command module. ignore_errors: yes allows the playbook to continue if the volume already exists.
- Run Portainer Docker Container: Deploys the Portainer container using the docker_container module.

Run the Ansible Playbook:

To run the playbook, use the following command:
```
ansible-playbook -i "your_server_ip," portainer_install.yml -u your_user_name -k
```
Replace your_server_ip with the IP address of your Debian 12 server, your_user_name with your username on the server, and -k prompts you for the user password. You’ll want to set up SSH keys for passwordless authentication in a production environment.

This method allows you to automate the installation process across multiple servers, ensuring consistency and reducing manual effort.

Both alternative solutions provide robust ways to Install Portainer Docker GUI on Debian 12, catering to different needs and preferences. Choose the method that best aligns with your environment and requirements.