Skip to content

Advanced usage

per1234 edited this page Aug 3, 2024 · 6 revisions

The configuration file location

The default config.ini file contains common configurations. The location of the config.inidepends on the OS:

  • On Unix systems, it's located inside $XDG_CONFIG_HOME/ArduinoCreateAgent/config.ini as specified here. If $XDG_CONFIG_HOMEis empty, the location will be in $HOME/.config/ArduinoCreateAgent/config.ini.
  • On macOS, it's located in $HOME/Library/Application Support/ArduinoCreateAgent/config.ini.
  • On Windows, it's located in %AppData%\ArduinoCreateAgent\config.ini.

If you need to know the exact location of the config, or you need to modify it, you can use the "Open Configuration" menu in the tray icon menu.

Using multiple configurations

The agent supports multiple configuration files. The additional configurations will override the main one (config.ini). When multiple configurations are found by the agent, the tray icon menu is expanded to contain the different configurations:

To create multiple configuration files:

  1. Click the Arduino Cloud Agent tray bar icon.

  2. Select Quit Agent from the menu.

  3. Find the config.ini file (see section above).

  4. Copy config.ini or create a new ini file (e.g. example.ini) with content:

    name = your configuration name

    Add in this file other configuration options (you can override inherited values from config.ini)

  5. Restart the agent.

  6. Click the tray bar icon.

  7. Select the new configuration.

Tip: you can also use the multiple configurations feature to create a new configuration with the proxy settings. This way you can have multiple proxies configured and disable proxy configuration with ease.

When behind a proxy

The agent supports working behind a proxy, but manual configuration is required (there is no support for automatic proxy discovery).

To add proxy configuration, create an additional configuration file (e.g. proxy.ini) with content:

name = Proxy Enabled
[env]
httpProxy="your.proxy.here"
httpsProxy="your.https.proxyhere"
  • Please note, spaces are not allowed before and after the string httpProxy Remember to restart the agent and to select the proper Proxy profile, as in the image.

Your agent will now work behind a proxy.