Getting started

Getting started

Everything below takes about ten minutes. You need an account, an API key, and a board to flash.

What you need

  • An ESP32 (an ESP8266 also works)
  • A USB cable that carries data — some charging cables don’t
  • PlatformIO — the VS Code extension is the easiest way in
  • A 2.4 GHz WiFi network. ESP32 boards do not join 5 GHz networks.

1. Create an account

Sign up at sensordata.space. You’ll be asked to verify your email address before you can sign in.

2. Create an API key

The API key is how a device proves it belongs to you. Without one the platform has no way to tell your device apart from anyone else’s.

  1. Open the user menu (top right) and choose your email address to open your profile
  2. Scroll to Keys and create a new key
  3. Give it a name you’ll recognise later — workshop-esp32, greenhouse, whatever
  4. Copy the key immediately. The list afterwards shows only the name, the date, and which devices use it — never the key itself again.

You can create as many keys as you like, and delete one to cut off every device using it. The Devices column in the key list shows which devices are currently using each key, so you can tell at a glance what a key would break if you removed it.

3. Connect your first device

Head to Connecting a device. Once your device is running, it appears in your device list on its own — there’s nothing to register by hand.

Where things live

I want to…Go to
See all my devicesDevices — the landing page after sign-in
Open a device’s dashboardClick the device card, or its chart button
Rename a device, set notificationsThe gear button on a device card → Device settings
Let someone else see a deviceDevice settings → Access
Create or edit an API keyYour profile, from the user menu