Table of Contents

Docker - Install Portainer

Create a volume to host Portainer data

docker volume create portainer_data

returns

portainer_data

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.


Install the Portainer Docker Image

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

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.

Check that Portainer is running

docker ps

Configure Portainer

Navigate to http://yourdeviceip:9443.

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


Connect Portainer to Docker

Click Local and Connect.

NOTE: If using a remote Docker then select the appropriate Remote option.


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/