Docker image based on Debian Buster for running the Mozilla WebThings Gateway. The image is built for AMD64, ARMv7, and ARMv8 (AArch64).
While the gateway doesn't necessarily require full local network access, some
add-ons may. Therefore, it is best to run with the --network="host" flag.
Currently, this flag will not work when using
Docker for Mac or
Docker for Windows due to
this and
this.
-
On Linux:
docker run \ -d \ -e TZ=America/Los_Angeles \ -v /path/to/shared/data:/home/node/.mozilla-iot \ --network="host" \ --log-opt max-size=1m \ --log-opt max-file=10 \ --name webthings-gateway \ mozillaiot/gateway:latest -
On Windows or macOS:
docker run \ -d \ -p 8080:8080 \ -p 4443:4443 \ -e TZ=America/Los_Angeles \ -v /path/to/shared/data:/home/node/.mozilla-iot \ --log-opt max-size=1m \ --log-opt max-file=10 \ --name webthings-gateway \ mozillaiot/gateway:latest
-d- Run in daemon mode (in the background)-e TZ=America/Los_Angeles- Set the time zone toAmerica/Los_Angeles. The list of names can be found here.-v /path/to/shared/data:/home/node/.mozilla-iot- Change/path/to/shared/datato some local path. We are mounting a directory on the host to the container in order to store the persistent "user profile" data, e.g. add-ons, logs, configuration data, etc.--network="host"- Shares host networking with container (highly recommended, needed by some addons, -p is ignored if this option is used).-p 8080:8080/-p 4443:4443- Forward necessary ports to the container (ignored if--network="host"is present).--log-opt max-size=1m- limit the log size to 1 MB--log-opt max-file=10- limit the number of saved log files to 10--name webthings-gateway- Name of the container.
Create a file local.json and map it to
/path/to/shared/data/config/local.json (where /path/to/shared/data is the
volume mounted to /home/node/.mozilla-iot). Contents of the file:
{
"ports": {
"https": 8081,
"http": 8080
}
}Edit the ports as you like.
docker-compose up -d
After running the container, you can connect to it at: http://<host-ip-address>:8080
If you'd like to build an image yourself, run the following:
git clone https://github.com/mozilla-iot/gateway-docker
cd gateway-docker
docker build -t gateway .
docker run \
-d \
-e TZ=America/Los_Angeles \
-v /path/to/shared/data:/home/node/.mozilla-iot \
--network="host" \
--log-opt max-size=1m \
--log-opt max-file=10 \
--name webthings-gateway \
gatewayYou can add the following build args:
--build-arg "gateway_url=https://github.com/<your-fork>/gateway"--build-arg "gateway_branch=<your-branch>"--build-arg "gateway_addon_version=<your-version>"
- If you need to use Zigbee, Z-Wave, or some other add-on which requires
physically attached hardware, you will have to share your device into your
container, e.g.
--device /dev/ttyACM0:/dev/ttyACM0. They will also need to be owned by GID 20, which corresponds to thedialoutgroup in the container. This can be done using udev rules or something else. - If you need to use GPIO in the container (e.g. on a Raspberry Pi host), you
will need to either run in privileged mode with
--privilegedor share in your sysfs filesystem with-v /sys:/sys. The sysfs nodes will also need to be owned by GID 997, which corresponds to thegpiogroup in the container. - If you need to use Bluetooth in the container, you will need to disable BlueZ
on the host (if running), e.g.
systemctl disable bluetooth, and you will need to run the container in privileged mode, i.e.--privileged.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent