New gateway add
The SolarTools IoT and energy management infrastructure utilizes a local gateway software (Gateway Agent) running on the local network to harvest telemetry data from edge hardware like meters, inverters, weather stations, and PLCs.
By following the step-by-step setup guide and screenshots below, you will define a gateway instance on the portal, retrieve its secure access token, and deploy the agent on your physical edge computer to establish the communication bridge in under 5 minutes.
Installation Lifecycle
You can visualize the sequential milestones of the edge installation using the dynamic flow chart below:
Gateway Register
Define the new gateway on the portal.
Security Token
Copy the unique Auth Key credential.
Edge Deployment
Run the installation command on your Linux server.
Live Streams
Verify the online connection status on the portal.
Step-by-Step Installation & Configuration
Follow the 6 steps sequentially. You can hover over the screenshots inside the cards to use the magnifier, or click on them to enlarge to full-screen (HD) view:
Define New Gateway on Portal
After logging in to the SolarTools platform, navigate to the Devices → Gateways tab on the left sidebar. Click the Add New Gateway button located in the top-right corner to initiate the registration process.
Enter Gateway Details
Fill in the fields in the modal form. Provide a descriptive Name for your gateway (e.g., Main Plant OSB Gateway), set its location coordinates, and add any helpful site details. Click Save to confirm registration.
Copy the Access Token (Auth Key)
Once successfully registered on the portal, a secure and unique Auth Key (Token) will be generated. Copy this key immediately; it will be used to safely bind your physical industrial PC to your SolarTools cloud account.
Execute Installation Script
Connect to your local industrial PC (e.g., Raspberry Pi, IPC) on the field via SSH or direct console. Execute the 1-click SolarTools automated installation command, and paste your copied Auth Key when prompted by the setup wizard.
Verify Service Status
After the install script finishes, the gateway daemon is registered as a background systemd service (solartools-gateway.service). Run systemctl status solartools-gateway to verify that the daemon status is active and running.
Confirm Portal Connection Status
Head back to the Gateways list on the SolarTools cloud console. Verify that the indicator dot next to your newly created gateway has turned **Green (Online)**, confirming that the physical gateway is streaming live heartbeats to the cloud.
What's Next?
Congratulations! You have successfully established the secure communication pipeline (Gateway) between your edge device and the SolarTools cloud.
Next, you need to define the physical device protocols and data mappings. Proceed to the Add Connector guide to configure communication interfaces like Modbus, MQTT, or OPC-UA.