Please select an option to see content specific to your location and shop online.

  • Free delivery on orders over £25 Free delivery on orders over £25


Get started with WebThings Gateway Kit

Everything you need to set up a private IoT network

Scroll down

Mozilla WebThings is Mozilla’s open-source implementation of the Web of Things, including the WebThings Gateway and the WebThings framework which connects real-world objects to the internet. This allows you to create smart devices for your home and control them remotely without the need for middle man applications.

1.Insert Pi into case

insert raspberry pi in case

  • Slide the Raspberry Pi into the base of the plastic case ensuring that you align and insert the power, HDMI and audio ports into their respective openings.

adjust raspberry pi in case

  • Position the Raspberry PI so that it sits on the mounting points of the case.

slide lid

  • Slide the case’s lid into position and push it all the way in.


2. Insert pre-flashed micro SD card

Insert micro sd card

  • Fully insert the pre-flashed micro SD card.


3. Connect power

  • Connect the power cable to the port shown above.
  • Plug the power supply into a socket.
  • Wait for your Pi to boot, this can take up to 3-4mins, way longer than the usual start-up time.


4. Configure WiFi network

  • From your host computer or smartphone, look for and connect to WebThings Gateway in your available networks. Its SSID will be WebThings Gateway XXXX

webthings ssid

A window will appear displaying available WiFi networks.

  • Select your network and enter the password when prompted and click Connect.
  • A page will appear, showing nearby Wi-Fi networks.

  • Select the desired network and enter the password when prompted. The “Connecting to WiFi…” page will automatically disappear.


5. Create secure subdomain

You can skip this step if you’ll only be using the gateway locally or if you’ll be manually configuring DNS. If you skip it and change your mind later on, you’ll need to re-flash the micro-sd card in order to register a subdomain.

  • From a computer or smartphone connected to the same network as your gateway, point a browser to http://gateway.local/


  • Enter a subdomain in the relevant field. Make sure that it’s something memorable.
  • Enter a valid email address in the email field.
  • Click Create.

The system will process your request, this will take a little while


6. Create user account

Once you’ve created a subdomain, you’ll be presented with the user account window. A user account is how you’ll access the gateway to manage your devices.

user account webthings

  • Fill in all the fields and click Next.

You’ll be presented with a blank screen bearing the message No devices yet.


7. Add-ons

The WebThings Gateway uses an add-on system to let it understand how different connected devices and services work. For each type of device or service, you’ll need to install and configure the relevant add-on so the gateway can use it to discover and connect to them. This example shows how to install the Weather add-on so you can connect to an open weather information service and display current conditions.

webthings no devices

  • Click on the menu icon on the top left and navigate to Settings>Add-ons.

webthings addons

  • Click on the + icon on the bottom right. You’ll be presented with an alphabetical list of add-ons.
  • Navigate to the Weather add-on and click Add.

After a little while, the add-on will display as Added and you’ll get a message saying that no locations are configured.

  • Click on the back arrow. This will take you to the list of installed add-ons.
  • Find the Weather add-on and click Configure.

configure weather add-on

  • Click on + under Locations.
  • Enter the name of the location you want to track and its latitude and longitude, you can find that information here.
  • Set the units that you want to use. You can leave the default Open-WeatherMap API key selected.
  • Click on Apply.
  • Click on the back arrow twice and then select Things from the menu.
  • Click on the + to scan for devices. This should discover the Weather thing with your specified location name.
  • Click Save.

You should now be able to view weather data by going to the main Things page to see the installed Weather thing.

weather thing


Do more

Now that you have your WebThings up and running, you can refer to the following resources for further functionality and configuration:

Like what you read? Why not show your appreciation by giving some love.

From a quick tap to smashing that love button and show how much you enjoyed this project.