aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 34f9f476e05a3bb3e7a16836667bbb68a2551175 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# mqtt

Documentation and source code for the departmental mqtt server hosted at https://mqtt.chem.wisc.edu.

To prepare (starting with Ubuntu 20.04)
```
$ apt install docker.io
$ apt install docker-compose
```

This machine needs the following ports to be open to the campus network:
- 80 (http) (used via reverse proxy)
- 1883 (mqtt)
- 8086 (influxdb)

To run:
```
$ docker-compose up -d --build
```

Volumes:

This compose file will create a docker volume `mqtt_influxdb`.
This volume contains the influx database itself and should be backed up.
On the host machine it appears at `/var/lib/docker/volumes/mqtt_influxdb/`.

## Repository

This repository is being mirrored to several version control systems in an attempt to ensure maximum availability.

| name             | url                                                           |
| ---------------- | ------------------------------------------------------------- |
| blaise           | https://git.blaise.zone/uw-madison-chem-shops/mqtt.git/about/ | 
| Codeburg         | https://codeberg.org/uw-madison-chem-shops/mqtt               |
| GitHub (primary) | https://github.com/uw-madison-chem-shops/mqtt                 |
| GitLab           | https://gitlab.com/uw-madison-chem-shops/mqtt                 |