You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- the IP address of your Raspberry Pi (eg `192.168.1.10`)
13
13
- the multicast domain name of your Raspberry Pi (eg `iot-hub.local`)
14
14
- the domain name of your Raspberry Pi (eg `iot-hub.mydomain.com`)
15
15
16
-
## About *Portainer CE*
16
+
## <aname="about"> About *Portainer CE* </a>
17
17
18
18
*Portainer CE* (Community Edition) is an application for managing Docker. It is a successor to *Portainer*. According to [the *Portainer CE* documentation](https://www.portainer.io/2020/08/portainer-ce-2-0-what-to-expect/)
19
19
20
20
> Portainer 1.24.x will continue as a separate code branch, released as portainer/portainer:latest, and will receive ongoing security updates until at least 1st Sept 2021. No new features will be added beyond what was available in 1.24.1.
21
21
22
22
From that it should be clear that *Portainer* is deprecated and that *Portainer CE* is the way forward.
23
23
24
-
## *Portainer CE* coexistence with *Portainer*
25
-
26
-
IOTstack has been set up so that *Portainer CE* and *Portainer* can coexist. This is intended as a short-term migration aid rather than a long-term proposition.
27
-
28
-
If you are a first-time user of IOTstack, you should choose *Portainer CE* and forget about *Portainer*.
Portainer CE | ~/IOTstack/volumes/portainer-ce | [B]
57
-
58
-
If you have been running *Portainer* but have **never** run *Portainer CE* then:
59
-
60
-
*[A] will exist, but
61
-
*[B] will not exist.
62
-
63
-
Whenever "Portainer-ce" is enabled in `menu.sh`, a check is made for the **presence** of [A] combined with the **absence**[B]. If and only if that situation exists, [B] is initialised as a copy of [A].
64
-
65
-
This one-time copy is intended to preserve your *Portainer* settings and admin user password for use in *Portainer CE*. Thereafter, any settings you change in *Portainer CE* will not be reflected in *Portainer*, nor vice versa.
43
+
## <aname="firstRun"> First run of *Portainer CE* </a>
66
44
67
-
## Port Number = 9002
45
+
In your web browser navigate to `#yourip:9000/`:
68
46
69
-
Both *Portainer CE* and *Portainer* are usually configured to listen to port 9000 but, in the IOTstack implementation:
47
+
- the first screen will suggest a username of "admin" and ask for a password. Supply those credentials and click "Create User".
48
+
- the second screen will ask you to select a connection method. For IOTstack, "Docker (Manage the local Docker environment)" is usually appropriate so click that and then click "Connect".
70
49
71
-
**Portainer CE* uses port 9002; and
72
-
**Portainer* uses port 9000.
73
-
74
-
> You can always change the port numbers in your `docker-compose.yml`.
75
-
76
-
## First run of *Portainer CE*
77
-
78
-
In your web browser navigate to `#yourip:9002/`.
79
-
80
-
* If you are migrating from *Portainer*:
81
-
82
-
- review the [Migration note](#MigrationNote) which explains why your *Portainer* credentials will likely apply to *Portainer CE*, and then
83
-
- supply your *Portainer* credentials.
84
-
85
-
* <aname="NewAccount"> If you are **not** migrating from *Portainer*: </a>
86
-
87
-
- the first screen will suggest a username of "admin" and ask for a password. Supply those credentials and click "Create User".
88
-
- the second screen will ask you to select a connection method. For IOTstack, "Docker (Manage the local Docker environment)" is usually appropriate so click that and then click "Connect".
89
-
90
-
From there, you can click on the "Local" group and take a look around. One of the things *Portainer CE* can help you do is find unused containers but beware of reading too much into this because, sometimes, an "unused" container is actually the base for another container (eg Node-Red).
50
+
From there, you can click on the "Local" group and take a look around. One of the things *Portainer CE* can help you do is find unused containers but beware of reading too much into this because, sometimes, an "unused" container is actually the base for another container (eg Node-RED).
91
51
92
52
There are 'Quick actions' to view logs and other stats. This can all be done from terminal commands but *Portainer CE* makes it easier.
93
53
94
-
## Ceasing use of Portainer
95
-
96
-
As soon as you are happy that *Portainer CE* meets your needs, you can dispense with *Portainer*. IOTstack only has limited support for getting rid of unwanted services so you should do the following.
97
-
98
-
1. Stop Portainer from running and remove its image:
99
-
100
-
```
101
-
$ cd ~/IOTstack
102
-
$ docker-compose stop portainer
103
-
$ docker-compose rm -f portainer
104
-
$ docker rmi portainer/portainer
105
-
```
106
-
107
-
2. Either:
108
-
109
-
- run `menu.sh`
110
-
- choose "Build Stack"
111
-
- de-select "portainer", and
112
-
- follow through to the end choosing "Do not overwrite" for existing services,
113
-
114
-
or:
115
-
116
-
- edit `docker-compose.yml` and remove these lines:
117
-
118
-
```
119
-
portainer:
120
-
container_name: portainer
121
-
image: portainer/portainer
122
-
restart: unless-stopped
123
-
ports:
124
-
- "9000:9000"
125
-
volumes:
126
-
- /var/run/docker.sock:/var/run/docker.sock
127
-
- ./volumes/portainer/data:/data
128
-
```
129
-
130
-
- edit `services/selection.txt` and remove this line:
131
-
132
-
```
133
-
portainer
134
-
```
135
-
136
-
3. Tidy-up:
137
-
138
-
```
139
-
$ cd ~/IOTstack
140
-
$ rm -rf ./services/portainer
141
-
$ sudo rm -rf ./volumes/portainer
142
-
```
143
-
144
-
## Setting the Public IP address for your end-point
54
+
## <aname="setPublicIP"> Setting the Public IP address for your end-point </a>
145
55
146
56
If you click on a "Published Port" in the "Containers" list, your browser may return an error saying something like "can't connect to server" associated with an IP address of "0.0.0.0".
147
57
@@ -169,7 +79,7 @@ Keep in mind that clicking on a "Published Port" does not guarantee that your br
169
79
170
80
> All things considered, you will get more consistent behaviour if you simply bookmark the URLs you want to use for your IOTstack services.
171
81
172
-
## If you forget your password
82
+
## <aname="forgotPassword"> If you forget your password </a>
173
83
174
84
If you forget the password you created for *Portainer CE*, you can recover by doing the following:
0 commit comments