Installation

How simple is it to deploy Portainer?

Portainer installation using Docker

Portainer runs as a lightweight Docker container (the Docker image weights 3MB) on a Docker engine or Swarm cluster. Therefore, you are one command away from running container on any machine using Docker.

Deploy Portainer

Use the following Docker command to run Portainer:

											docker run -d -p 9000:9000 portainer/portainer
										
You'll just need to access the port 9000 of the Docker engine where portainer is running using your browser.

Deploy Portainer on Windows

We also support Docker on Windows (which is different than Docker for Windows, please ensure you know your type of installation first). NOTE: Portainer does not support local endpoint management via npipe:// yet, you'll have to expose a TCP port in the Docker configuration first, see the Docker documentation for more details. Once you Docker engine is configured, you'll have to specify your Docker host IP address to the Portainer container:

											docker run -d -p 9000:9000 portainer/portainer:windows -H tcp://DOCKER_HOST_IP:DOCKER_HOST_PORT
										
You'll need to replace DOCKER_HOST_IP with the IP address of your Windows host and DOCKER_HOST_PORT with the exposed port of your Docker engine. Then access the port 9000 of the Docker engine where portainer is running using your browser.

Manage a Swarm cluster with Portainer

Deploying Portainer to manage a Swarm cluster is just as easy ! You just need to know that you must point Portainer at a either a primary node when connecting to a Docker Swarm cluster or a manager node when connecting to a cluster created with Docker swarm mode.

And more deployment scenarios

Have a look at our installation documentation for more deployment scenarios such as Portainer with data persistence, TLS authentication enabled engine, non-Docker setup or reverse proxy integrations.

Access the documentation