====== 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 9000:9000 -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data --restart always portainer/portainer
</code>

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

----

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

<code bash>
docker ps
</code>

----

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

Navigate to http://yourdeviceip:9000.

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>


----