Portainer

Easily deploy, configure and secure containers in minutes on Docker, Kubernetes, Swarm and Nomad in any cloud, datacenter or device.

Project Homepage: Portainer Documentation: Portainer Docs

Installation

There are two installation options: Portainer CE (Community Edition) and Portainer BE (Business Edition). Up to three nodes of BE can be requested at no cost; documentation outlining the feature differences between BE and CE here.

Requirements: Docker, Docker Swarm, or Kubernetes must be installed to run Portainer. Docker is also recommended but not required.

The examples below focus on installing Community Edition (CE) on Linux but Windows and Windows Container Service installation instructions (very little, if any, difference) can also be accessed from the hyperlinks above.

Deploy Portainer CE in Docker on Linux

Create the volume that Portainer Server will use to store its database.

docker volume create portainer_data

Download and install the Portainer Server container.

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:latest

Check to see whether the Portainer Server container has started by running.

docker ps

Log into your Portainer Server in a web browser at URL https://your-server-address:9443.

Deploy Portainer CE in Docker Swarm on Linux

Retrieve the stack YML manifest.

curl -L https://downloads.portainer.io/ce2-19/portainer-agent-stack.yml -o portainer-agent-stack.yml

Use the downloaded YML manifest to deploy your stack.

docker stack deploy -c portainer-agent-stack.yml portainer

Check to see whether the Portainer Server container has started by running.

docker ps

Log into your Portainer Server in a web browser at URL https://your-server-address:9443.

Add environments to Portainer

Various protocols can be used for Portainer node monitoring including:

Portainer Agent (running as a container on the client)
URL/IP address
Socket

The method that requires least configuration, and least additional external accessibility, is the Portainer Agent.
Running a docker command on the client machine will install the Portainer agent -- the appropriate docker command can be obtained in Portainer by:

Clicking "Environments" in the left side navigation pane
Click the blue button labled "+Add Environment" in the top-right corner
Click the appropriate environment (Docker Standalone, Docker Swarm, K8S, etc.)
Copy the docker string in the middle of the window and execute on the client
Enter a name and IP (ending in :9001) in the fields below and click "Connect"

Updating Portainer (host)

In this example the container name for Portainer is "Portainer"; change this if necessary for your installation.

docker stop portainer && docker rm portainer && docker pull portainer/portainer-ce:latest && 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:latest

Updating Portainer Agent (clients)

docker stop portainer_agent && docker rm portainer_agent && docker pull portainer/agent:latest && docker run -d -p 9001:9001 --name=portainer_agent --restart=always -v /v
ar/run/docker.sock:/var/run/docker.sock -v /var/lib/docker/volumes:/var/lib/docker/volumes portainer/agent:latest

3.9 KiB Raw Blame History