User Tools

Site Tools


docker:portainer:install_portainer

This is an old revision of the document!


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

docker/portainer/install_portainer.1747761753.txt.gz · Last modified: 2025/05/20 17:22 by peter

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki