Atmosphere IoT Agent

The Atmosphere IoT Agent is a local application that runs in your computer’s system tray, and acts as an intermediary between the computer’s connectivity protocol drivers and the browser running Atmosphere.

Agent Icon

It is used for programming hardware, and enables you to program an end device from within Atmosphere. The agent is also used to assist in connecting it to Atmosphere by searching your computer for any compatible device connected to it from an available communication port. While the agent is running, a device with Atmosphere firmware installed on it can be registered to Atmosphere directly without the assistance from an additional connection like BLE or Wi-Fi if it’s connected to your computer.


Operating System Support Version Link
Windows Windows 7 and up 1.3.2 Download
Linux All Linux platforms 1.3.2 Download
macOS macOS 10.4 and up 1.3.2 Download



Run the downloaded installation .exe, then specify the local directory where to install the agent.


Navigate to the directory that contains the downloaded .AppImage file. Run chmod u+x on the downloaded file, and add the current user to the dialout group on your system: sudo adduser $USER dialout. Alternatively, you can run the .AppImage as root (not recommended) .

NOTE: These instructions have been verified to work on Ubuntu/Debian based distributions. Tailor the suggested commands to your particular distribution.


Run the downloaded installation .dmg, then drag and drop the Atmosphere IoT icon inside the DMG view into the Applications folder on your system.

For USB-C only Macbooks

Install the Silicon Labs VCP UART drivers here in order to get the IoT Agent to communicate via USB-C adapters for your ESP32.

Running the Agent

Using the Atmosphere IoT Agent simply involves running it in the background of your computer during programming, no additional instructions or usage is involved.

The Atmosphere IoT Agent has a known issue while running Atmosphere in Firefox, where a security exception for the agent needs to be added to communicate in the browser. Without the exception, Firefox won't allow Atmosphere to communicate to your computer.

To set up a security exception certificate for Firefox:

  1. Close all open Firefox windows, and close the Atmosphere IoT Agent.
  2. Relaunch both Firefox and the agent.
  3. In Firefox, open the browser menu and click Options.
  4. From the Options menu, click Privacy & Security.
  5. From the Privacy & Security menu, scroll down to the Security section, then under Certificates click View Certificates.
  6. From the Certificate Manager window, click the Servers tab.
  7. In the Servers tab, click Add Exception.
  8. In the Location field, enter https://localhost:48701, then click Get Certificate.
  9. Select the Permanently store this exception checkbox, then click Confirm Security Exception to complete the process.

This enables Firefox to communicate to the agent’s server running on your computer. The next time you login to Atmosphere and attempt to program on Firefox, your browser should be able to communicate with your computer without issue.