Skip to content

Initial Set Up

Once Portainer is deployed and you have navigated to http://ip-server:9000, you will see the following screens.

Set Password Admin

The first thing to do is set a password for the admin user. This password needs to be at least eight characters long.


The password can also be set up from the command line or from a configuration file:

From the command line

Portainer allows you to specify a bcrypt encrypted password from the command line for the admin account. You need to generate the bcrypt encrypted password first.

You can generate the encrypted password with the following command:

$ htpasswd -nb -B admin  | cut -d ":" -f 2

or if your system does not provide htpasswd you can use a docker container with the command:

$ docker run --rm httpd:2.4-alpine htpasswd -nbB admin "password" | cut -d ":" -f 2

To specify the admin password from the command line, start Portainer with the --admin-password flag:

$ docker run -d -p 9000:9000 -p 8000:8000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer --admin-password='$2y$05$qFHAlNAH0A.6oCDe1/4W.ueCWC/iTfBMXIHBI97QYfMWlMCJ7N.a6'

Inside a file

You can also store the plaintext password inside a file and use the --admin-password-file flag:

$ echo -n mypassword > /tmp/portainer_password
$ docker run -d -p 9000:9000 -p 8000:8000 -v /var/run/docker.sock:/var/run/docker.sock -v /tmp/portainer_password:/tmp/portainer_password portainer/portainer --admin-password-file /tmp/portainer_password

This works well with Swarm & Docker secrets too:

$ echo -n mypassword | docker secret create portainer-pass -
$ docker service create \
  --name portainer \
  --secret portainer-pass \
  --publish 9000:9000 \
  --publish 8000:8000 \
  --replicas=1 \
  --constraint 'node.role == manager' \
  --mount type=bind,src=/var/run/docker.sock,dst=/var/run/docker.sock \
  portainer/portainer \
  --admin-password-file '/run/secrets/portainer-pass' \
  -H unix:///var/run/docker.sock

Note: This will automatically create an administrator account called admin with the specified password.

Collection of statistics

We anonymously collect information about how Portainer is used via a tool called Matomo. You can disable this option, but we recommend leaving it activated. This will help us understand how our users use Portainer and improve it.

You can read more about our privacy policy here

You can enable or disable this using the checkbox shown:

statics This can be changed at any time via the Portainer Settings screen

Connect Portainer to the container environment

If you installed Portainer in Kubernetes you would choose Kubernetes, but if you installed in Docker, you may want choose manage the local Docker environment.



Once the appropriate option is selected, click connect. If everything works as expected, You will then be shown the Portainer home page.



Contribute to these docs.