2016-09-21 20:35:05 +00:00
|
|
|
#Eclipse Mosquitto v1.4.8 Docker Image
|
|
|
|
|
|
|
|
##Mount Points
|
|
|
|
|
|
|
|
Three mount points have been created in the image to be used for configuration, persistent storage and logs.
|
|
|
|
```
|
|
|
|
/mosquitto/config
|
|
|
|
/mosquitto/data
|
|
|
|
/mosquitto/log
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
##Configuration
|
|
|
|
|
|
|
|
When running the image, the default configuration values are used.
|
2017-01-21 08:22:13 +00:00
|
|
|
To use a custom configuration file, mount a **local** configuration file to `/mosquitto/config/mosquitto.conf`
|
2016-09-21 20:35:05 +00:00
|
|
|
```
|
2017-01-21 08:22:13 +00:00
|
|
|
docker run -it -p 1883:1883 -p 9001:9001 -v <path-to-configuration-file>:/mosquitto/config/mosquitto.conf mosquitto:1.4.8
|
2016-09-21 20:35:05 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
Configuration can be changed to:
|
|
|
|
|
|
|
|
* persist data to `/mosquitto/data`
|
|
|
|
* log to `/mosquitto/log/mosquitto.log`
|
|
|
|
|
|
|
|
i.e. add the following to `mosquitto.conf`:
|
|
|
|
```
|
|
|
|
persistence true
|
|
|
|
persistence_location /mosquitto/data/
|
|
|
|
|
|
|
|
log_dest file /mosquitto/log/mosquitto.log
|
|
|
|
```
|
|
|
|
|
|
|
|
**Note**: If a volume is used, the data will persist between containers.
|
|
|
|
|
|
|
|
##Build
|
|
|
|
Build the image:
|
|
|
|
```
|
|
|
|
docker build -t mosquitto:1.4.8 .
|
|
|
|
```
|
|
|
|
|
|
|
|
##Run
|
|
|
|
Run a container using the new image:
|
|
|
|
```
|
2017-01-21 08:22:13 +00:00
|
|
|
docker run -it -p 1883:1883 -p 9001:9001 -v <path-to-configuration-file>:/mosquitto/config/mosquitto.conf -v /mosquitto/data -v /mosquitto/log mosquitto:1.4.8
|
2016-09-21 20:35:05 +00:00
|
|
|
```
|
|
|
|
:boom: if the mosquitto configuration (mosquitto.conf) was modified
|
|
|
|
to use non-default ports, the docker run command will need to be updated
|
|
|
|
to expose the ports that have been configured.
|