Getting started

This section takes you from an empty account to a working Hermetry setup: an organisation, a connected device, a dashboard that shows its values, an alarm that opens when something is wrong, and colleagues who can sign in. Each page takes a few minutes. Follow them in order the first time; later, use them as a checklist when you set up a new organisation.

The route

Step	Page	Result
1	Create your account and choose a region	You own an organisation in the region you need, with its own web address.
2	Find your way around	You know the menu, the top bar, the bell and the guided tours.
3	Choose how to connect your devices	You know which way in (MQTT, HTTP, LoRaWAN, a gateway, polling) fits each device.
4	Connect your first device	A device sends readings over MQTT or HTTPS.
4a	Connect your first LoRaWAN sensor	A LoRaWAN gateway is online and a sensor’s first uplink is decoded.
5	Build your first dashboard	You see the device’s latest value and a chart on a board.
6	Set up your first alarm	An alarm opens when a value stays above a limit, and clears when it falls back.
7	Invite your team	Your colleagues sign in with the right role.
8	Go-live checklist	Your setup is ready for production.

If your project matches one of the five ready-made applications (water sites, remote sites, weather stations, sensor regions or personnel tracking), you can also start from a ready solution and adapt it instead of building every board and rule yourself.

Words used in these docs

Word	Meaning
Organisation	Your own space on Hermetry. Your devices, dashboards, rules and members belong to it, and nobody outside it sees them. The API and some screens call it a tenant or a workspace.
Region	Where your organisation’s data is kept: the European Union, the United States or Türkiye.
Member	A person who can sign in to your organisation. Each member has a role: Owner, Admin or User.
Device	Anything that sends data to Hermetry or receives commands from it: a sensor, a controller, a meter, a camera, a LoRaWAN gateway, a licensed router.
Licensed device	A router, gateway or controller made for Hermetry. It leaves the factory with its own identity and is added by claiming it. See Licensed devices.
Device profile	The settings shared by one kind of device: how it connects and logs in, its limits, how it counts as online, its keys, alarm rules and commands.
Credential	What a device logs in with: an access token, an MQTT username and password, or an X.509 certificate.
Telemetry	Time-stamped values a device sends, such as temperature or pressure. Each name is a key.
Attribute	A value that describes or configures a device, such as its firmware version or its reporting interval.
Dashboard	A board of cards (widgets) that shows data and lets people act on it.
Alarm	A record that something is wrong with a device. It has a severity (Critical, Major, Minor, Warning, Info) and a status (Open, Acknowledged, Resolved).
Rule	A “when this happens, do that” automation on a dashboard’s Rules card.
Flow	A graph of blocks that processes device messages. Every organisation has a root flow that stores the readings.
Site and asset	A place in your hierarchy (site, building, floor, room, line, machine). Devices are placed on assets.

More terms are explained in the Glossary.

Before you start

• You need an e-mail address you can read. Hermetry sends a verification message and, later, invitations and notifications to it.
• To connect a device you need the device, or a computer that can run an MQTT client or curl to stand in for it.
• Your devices must reach the internet on TCP port 8883 (MQTT over TLS) or 443 (HTTPS). LoRaWAN gateways need an outgoing secure websocket connection.
• Most setup steps need the Admin role. The person who creates the organisation is its Owner and can do everything.

Where to go next

You want to	Read
Learn devices in depth	Devices
Use LoRaWAN sensors	LoRaWAN
Build boards and process drawings	Dashboards, SCADA
Be told when something is wrong	Rules and alarms, Notifications
Manage people, roles and the plan	Administration
Connect your own software	API
Fix a problem	Troubleshooting