====== Docker - Install Portainer ======

===== Create a volume to host Portainer data =====

<code bash>
docker volume create portainer_data
</code>

returns

<code bash>
portainer_data
</code>

<WRAP info>
**NOTE:**  Portainer requires data persistence, and as a result needs at least one storage-class available to use.

Portainer will attempt to use the **default** storage class during deployment.

If you do NOT have a storage class tagged as **default** the deployment will likely fail.

</WRAP>

----

===== Install the Portainer Docker Image =====

<code bash>
docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:lts
</code>

<WRAP info>
**NOTE:**  This will run the container to pull, install and ensure it is always running.

  * By default, Portainer generates and uses a self-signed SSL certificate to secure port 9443.

  * Port 8000 is a SSH tunnel server and is used to create a secure tunnel between the agent and the Portainer instance.
    * Port 8000 is not required for all users of Portainer.
    * It is only necessary for those who plan to use the Edge compute features with Edge agents.
    * Edge computing refers to the ability to manage and deploy containers on remote devices or edge locations, such as on devices at the edge of a network.
    * Edge agents are components that run on these remote devices to communicate with Portainer and manage containers.

</WRAP>

----

====== Check that Portainer is running ======

<code bash>
docker ps
</code>

----

====== Configure Portainer ======

Navigate to http://yourdeviceip:9443.

Portainer will prompt you to set up a new password for your admin user.

{{:pi-hole:portainer_-_initial_login_admin_user_creation.png?800|}}

----

====== Connect Portainer to Docker ======

Click **Local** and **Connect**.

{{:pi-hole:portainer_-_connect_portainer_to_docker.png?800|}}

<WRAP info>
**NOTE:**  If using a remote Docker then select the appropriate **Remote** option.
</WRAP>


----

===== References =====

https://docs.portainer.io/start/install-ce/server/docker/linux

https://solid-future.com/docs/portainers-port-8000-9443-and-9000-in-docker-management/