This get started with WebThings Gateway Kit guide will teach you how to get ap and running with Raspberry and WebThings.
WebThings is an open-source implementation 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 middleman applications.
What you'll need
1 x Host computer or smartphone
Insert Pi into case
![insert raspberry pi in case](https://www.okdo.com/wp-content/uploads/2020/03/insert-pi-in-case.jpg?w=572)
- 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](https://www.okdo.com/wp-content/uploads/2020/03/adjust-pi-in-case.jpg?w=585)
- Position the Raspberry PI so that it sits on the mounting points of the case.
![slide lid](https://www.okdo.com/wp-content/uploads/2020/03/slide-lid-1.jpg?w=825)
- Slide the case’s lid into position and push it all the way in.
Insert pre-flashed microSD card
![insert mucro sd card](https://www.okdo.com/wp-content/uploads/2020/03/Insert-micro-sd-card.jpg?w=784)
- Fully insert the pre-flashed microSD card
Connect power
![connect power to webthings gateway kit](https://www.okdo.com/wp-content/uploads/2020/04/connect-power.jpg?w=783)
- 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.
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](https://www.okdo.com/wp-content/uploads/2020/04/webthings-ssid.jpg?w=370)
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.
![get started with WebThings Gateway Kit hifi connection](https://www.okdo.com/wp-content/uploads/2020/04/connect_wifi.png?w=800)
- Select the desired network and enter the password when prompted. The “Connecting to WiFi…” page will automatically disappear.
Create secure subdomain
- From a computer or smartphone connected to the same network as your gateway, point a browser to http://gateway.local/
![gateway set-subdomain](https://www.okdo.com/wp-content/uploads/2020/04/set-subdomain.jpg?w=1024)
- 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.
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.
![get started with WebThings Gateway Kit create account](https://www.okdo.com/wp-content/uploads/2020/04/user-account-webthings.jpg?w=1024)
- Fill in all the fields and click Next.
You’ll be presented with a blank screen bearing the message No devices yet.
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](https://www.okdo.com/wp-content/uploads/2020/04/webthings-no-devices.jpg?w=1024)
- Click on the menu icon on the top left and navigate to Settings>Add-ons.
![get started with WebThings Gateway Kit addons](https://www.okdo.com/wp-content/uploads/2020/04/webthings-addons.jpg?w=1024)
- 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.
![get started with WebThings Gateway Kit configure webthings weather add-on](https://www.okdo.com/wp-content/uploads/2020/04/configure-weather-add-on.jpg?w=1024)
- 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.
![get started with WebThings Gateway Kit weather webthing](https://www.okdo.com/wp-content/uploads/2020/04/weather-thing.jpg?w=1024)
Do more
Now that you have your WebThings up and running, you can refer to the following resources for further functionality and configuration: