Portainer
/
portainer-docs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

GitBook: [ce-2.6] 15 pages modified

ce-2.6
James Carppe 2021-09-27 02:51:17 +00:00 committed by gitbook-bot
parent ac6f530e52
commit 575dc3af4e
No known key found for this signature in database
GPG Key ID: 07D2180C7B12D0FF
15 changed files with 32 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
admin/upgrade/docker.md
View File

@ -25,13 +25,13 @@ docker rm portainer
Now that you have stopped and removed the old version of Portainer, you must ensure that you have the latest version of the image locally. You can do this with a `docker pull` command:
```text
docker pull portainer/portainer-ce
docker pull portainer/portainer-ce:2.6.3
```
Finally, deploy the updated version of Portainer:
```text
docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:2.6.3
```
The newest version of Portainer will now be deployed on your system, using the persistent data from the previous version, and will also upgrade the Portainer database to the new version.
@ -95,12 +95,12 @@ docker rm portainer_agent
Next, pull the updated version of the image:
```text
docker pull portainer/agent
docker pull portainer/agent:2.6.3
```
Finally, start the agent with the updated image:
```text
docker run -d -p 9001:9001 --name portainer_agent --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /var/lib/docker/volumes:/var/lib/docker/volumes portainer/agent
docker run -d -p 9001:9001 --name portainer_agent --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /var/lib/docker/volumes:/var/lib/docker/volumes portainer/agent:2.6.3
```

4
admin/upgrade/swarm.md
View File

@ -17,13 +17,13 @@ Make note of the service names for Portainer. You will need them later.
To upgrade Portainer Server to the latest version, run the command below \(replace the `portainer_portainer` service name if your setup differs\):
```text
docker service update --image portainer/portainer-ce --force portainer_portainer
docker service update --image portainer/portainer-ce:2.6.3 --force portainer_portainer
```
To upgrade the Portainer Agent to the latest version, run the command below \(replace the `portainer_agent` service name if your setup differs\):
```text
docker service update --image portainer/agent --force portainer_agent
docker service update --image portainer/agent:2.6.3 --force portainer_agent
```
This will deploy the newest version of Portainer and the agent across your swarm and upgrade the Portainer database to match.

14
advanced/cli.md
View File

@ -158,7 +158,7 @@ docker run --rm httpd:2.4-alpine htpasswd -nbB admin "your-password" | cut -d ":
Once the password has been created, specify the admin password from the command line by starting Portainer with the `--admin-password` flag:
```text
docker run -d -p 9000:9000 -p 8000:8000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer-ce --admin-password='$2y$05$8oz75U8m5tI/xT4P0NbSHeE7WyRzOWKRBprfGotwDkhBOGP/u802u'
docker run -d -p 9000:9000 -p 8000:8000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer-ce:2.6.3 --admin-password='$2y$05$8oz75U8m5tI/xT4P0NbSHeE7WyRzOWKRBprfGotwDkhBOGP/u802u'
```
### Method 2: Creating the account using a file
@ -172,7 +172,7 @@ echo -n mypassword > /tmp/portainer_password
Next, start the Portainer container:
```text
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-ce --admin-password-file /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-ce:2.6.3 --admin-password-file /tmp/portainer_password
```
This also works well with Docker Swarm and Docker Secrets:
@ -190,7 +190,7 @@ docker service create \
--replicas=1 \
--constraint 'node.role == manager' \
--mount type=bind,src=/var/run/docker.sock,dst=/var/run/docker.sock \
portainer/portainer-ce \
portainer/portainer-ce:2.6.3 \
--admin-password-file '/run/secrets/portainer-pass' \
-H unix:///var/run/docker.sock
```
@ -206,13 +206,13 @@ docker run -d --label owner=acme nginx
To hide this container, when starting Portainer add the `-l owner=acme` option on the CLI:
```text
docker run -d -p 9000:9000 -p 8000:8000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer-ce -l owner=acme
docker run -d -p 9000:9000 -p 8000:8000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer-ce:2.6.3 -l owner=acme
```
To hide multiple containers, repeat the `-l` flag:
```text
docker run -d -p 9000:9000 -p 8000:8000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer-ce -l owner=acme -l service=secret
docker run -d -p 9000:9000 -p 8000:8000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer-ce:2.6.3 -l owner=acme -l service=secret
```
## Using your own logo
@ -224,7 +224,7 @@ Images must be exactly 155px by 55px in size.
Replace our logo with your own using the `--logo` flag to specify the location of the image file:
```text
docker run -d -p 9000:9000 -p 8000:8000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer-ce --logo "https://www.docker.com/sites/all/themes/docker/assets/images/brand-full.svg"
docker run -d -p 9000:9000 -p 8000:8000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer-ce:2.6.3 --logo "https://www.docker.com/sites/all/themes/docker/assets/images/brand-full.svg"
```
You can also update the logo in the Portainer UI \(**Settings** menu\).
@ -240,6 +240,6 @@ Portainer allows you to rapidly [deploy containers using app templates](../user/
Templates are loaded once when Portainer is first started. If you already deployed a Portainer instance then decide to use your own templates, you’ll need to clear the default templates either in the user interface or through the HTTP API. Use the `--templates` flag to specify a URL where the template file can be accessed via HTTP.
```text
docker run -d -p 9000:9000 -p 8000:8000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer-ce --templates http://my-host.my-domain/templates.json
docker run -d -p 9000:9000 -p 8000:8000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer-ce:2.6.3 --templates http://my-host.my-domain/templates.json
```

6
advanced/reverse-proxy/nginx.md
View File

@ -21,7 +21,7 @@ services:
- "/var/run/docker.sock:/tmp/docker.sock:ro"
portainer:
image: portainer/portainer-ce
image: portainer/portainer-ce:2.6.3
command: -H unix:///var/run/docker.sock
restart: always
environment:
@ -93,7 +93,7 @@ services:
- "./vhost.d:/etc/nginx/vhost.d:ro"
agent:
image: portainer/agent
image: portainer/agent:2.6.3
environment:
# REQUIRED: Should be equal to the service name prefixed by "tasks." when
# deployed inside an overlay network
@ -111,7 +111,7 @@ services:
constraints: [node.platform.os == linux]
portainer:
image: portainer/portainer-ce
image: portainer/portainer-ce:2.6.3
command: -H tcp://tasks.agent:9001 --tlsskipverify
volumes:
- data:/data

6
advanced/reverse-proxy/traefik.md
View File

@ -39,7 +39,7 @@ services:
- "traefik.http.middlewares.redirect-to-https.redirectscheme.scheme=https"
portainer:
image: portainer/portainer-ce
image: portainer/portainer-ce:2.6.3
command: -H unix:///var/run/docker.sock
restart: always
volumes:
@ -150,7 +150,7 @@ services:
- "/var/run/docker.sock:/var/run/docker.sock:ro"
agent:
image: portainer/agent
image: portainer/agent:2.6.3
environment:
# REQUIRED: Should be equal to the service name prefixed by "tasks." when
# deployed inside an overlay network
@ -168,7 +168,7 @@ services:
constraints: [node.platform.os == linux]
portainer:
image: portainer/portainer-ce
image: portainer/portainer-ce:2.6.3
command: -H tcp://tasks.agent:9001 --tlsskipverify
volumes:
- data:/data

6
advanced/ssl.md
View File

@ -24,7 +24,7 @@ docker run -d -p 443:9000 -p 8000:8000 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer_data:/data \
-v ~/local-certs:/certs \
portainer/portainer-ce --ssl --sslcert /certs/portainer.crt --sslkey /certs/portainer.key
portainer/portainer-ce:2.6.3 --ssl --sslcert /certs/portainer.crt --sslkey /certs/portainer.key
```
As an alternative, Certbot can be used to generate a certificate and a key. However, because Docker has issues with symlinks, if you use Certbot, you will need to pass both the 'live' and 'archive' directories as volumes \(shown below\).
@ -36,7 +36,7 @@ docker run -d -p 443:9000 -p 8000:8000 \
-v portainer-data:/data \
-v /etc/letsencrypt/live/yourdomain:/certs/live/yourdomain:ro \
-v /etc/letsencrypt/archive/yourdomain:/certs/archive/yourdomain:ro \
portainer/portainer-ce --ssl --sslcert /certs/live/yourdomain/cert.pem --sslkey /certs/live/yourdomain/privkey.pem
portainer/portainer-ce:2.6.3 --ssl --sslcert /certs/live/yourdomain/cert.pem --sslkey /certs/live/yourdomain/privkey.pem
```
Now, you can navigate to `https://$ip-docker-host`.
@ -77,7 +77,7 @@ services:
constraints: [node.platform.os == linux]
portainer:
image: portainer/portainer-ce:latest
image: portainer/portainer-ce:2.6.3
command: -H tcp://tasks.agent:9001 --tlsskipverify --ssl --sslcert /run/secrets/portainer.example.com.cer --sslkey /run/secrets/portainer.example.com.key
ports:
- "9000:9000"

2
start/install/agent/docker/linux.md
View File

@ -21,7 +21,7 @@ The installation instructions also make the following assumptions about your env
Run the following command to deploy the Portainer Agent:
```bash
docker run -d -p 9001:9001 --name portainer_agent --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /var/lib/docker/volumes:/var/lib/docker/volumes portainer/agent
docker run -d -p 9001:9001 --name portainer_agent --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /var/lib/docker/volumes:/var/lib/docker/volumes portainer/agent:2.6.3
```
## Adding Your New Endpoint

2
start/install/agent/docker/wcs.md
View File

@ -15,7 +15,7 @@ You will need:
To run Portainer Agent in a Windows Container scenario, you need to execute the following commands:
```bash
docker run -d -p 9001:9001 --name portainer_agent --restart=always -v \\.\pipe\docker_engine:\\.\pipe\docker_engine portainer/agent
docker run -d -p 9001:9001 --name portainer_agent --restart=always -v \\.\pipe\docker_engine:\\.\pipe\docker_engine portainer/agent:2.6.3
```
## Adding Your New Endpoint

2
start/install/agent/docker/wsl.md
View File

@ -22,7 +22,7 @@ The installation instructions also make the following assumptions about your env
Run the following command to deploy the Portainer Agent:
```bash
docker run -d -p 9001:9001 --name portainer_agent --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /var/lib/docker/volumes:/var/lib/docker/volumes portainer/agent
docker run -d -p 9001:9001 --name portainer_agent --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v /var/lib/docker/volumes:/var/lib/docker/volumes portainer/agent:2.6.3
```
## Adding Your New Endpoint

2
start/install/server/docker/linux.md
View File

@ -31,7 +31,7 @@ docker volume create portainer_data
Then, download and install the Portainer Server container:
```bash
docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:2.6.3
```
Portainer Server has now been installed. You can check to see whether the Portainer Server container has started by running `docker ps`:

2
start/install/server/docker/wcs.md
View File

@ -48,7 +48,7 @@ docker volume create portainer_data
Then, download and install the Portainer Server container:
```text
docker run -d -p 9000:9000 --name portainer --restart always -v \.\pipe\docker_engine:\.\pipe\docker_engine -v portainer_data:C:\data portainer/portainer-ce
docker run -d -p 9000:9000 --name portainer --restart always -v \.\pipe\docker_engine:\.\pipe\docker_engine -v portainer_data:C:\data portainer/portainer-ce:2.6.3
```
## Logging In

2
start/install/server/docker/wsl.md
View File

@ -32,7 +32,7 @@ docker volume create portainer_data
Then, download and install the Portainer Server container:
```bash
docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
docker run -d -p 8000:8000 -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:2.6.3
```
Portainer Server has now been installed. You can check to see whether the Portainer Server container has started by running `docker ps`:

4
start/install/server/swarm/linux.md
View File

@ -32,7 +32,7 @@ Portainer can be directly deployed as a service in your Docker cluster. Note tha
First, retrieve the stack YML manifest:
```text
curl -L https://downloads.portainer.io/portainer-agent-stack.yml -o portainer-agent-stack.yml
curl -L https://downloads.portainer.io/ce2.6.3/portainer-agent-stack.yml -o portainer-agent-stack.yml
```
Then, use the downloaded YML manifest to deploy your stack:
@ -47,7 +47,7 @@ Portainer Server and the Agents have now been installed. You can check to see wh
root@manager01:~# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
59ee466f6b15 portainer/agent:latest "./agent" About a minute ago Up About a minute portainer_agent.xbb8k6r7j1tk9gozjku7e43wr.5sa6b3e8cl6hyu0snlt387sgv
2db7dd4bfba0 portainer/portainer-ce:latest "/portainer -H tcp:/…" About a minute ago Up About a minute 8000/tcp, 9000/tcp portainer_portainer.1.gpuvu3pqmt1m19zxfo44v7izx
2db7dd4bfba0 portainer/portainer-ce:2.6.3 "/portainer -H tcp:/…" About a minute ago Up About a minute 8000/tcp, 9000/tcp portainer_portainer.1.gpuvu3pqmt1m19zxfo44v7izx
```
## Logging In <a id="logging-in"></a>

2
start/install/server/swarm/wcs.md
View File

@ -50,7 +50,7 @@ Portainer can be directly deployed as a service in your Docker cluster. Note tha
You can use our YML manifest to run Portainer in Windows using Windows Containers. In PowerShell, run:
```bash
curl https://downloads.portainer.io/portainer_windows_stack.yml -o portainer_windows_stack.yml
curl https://downloads.portainer.io/ce2.6.3/portainer_windows_stack.yml -o portainer_windows_stack.yml
```
This will download the YML manifest. To deploy using this, run:

2
start/install/server/swarm/wsl.md
View File

@ -37,7 +37,7 @@ docker swarm init
To begin the installation, first retrieve the stack YML manifest:
```bash
curl -L https://downloads.portainer.io/portainer-agent-stack.yml -o portainer-agent-stack.yml
curl -L https://downloads.portainer.io/ce2.6.3/portainer-agent-stack.yml -o portainer-agent-stack.yml
```
Then, use the downloaded YML manifest to deploy your stack: