Advanced usage

Using multiple configurations

The agent supports multiple configuration files. When multiple configurations are found by the agent, the tray icon menu is expanded to contain the different configurations:

The default config.ini file contains common configurations, every other config file inherit from it.

To create multiple configuration files:

• click the Arduino Create Agent tray bar icon
• select Quit Agent from the menu
• find the config.ini file that is present in the arduino-create-agent installation folder
• 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)
• restart the agent
• click the tray bar icon and 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:

• click the Arduino Create Agent tray bar icon
• select Quit Agent from the menu
• find the config.ini file that is present in the arduino-create-agent installation folder
• copy config.ini to a new file (e.g. proxy.ini) with content:

  name = Proxy Enabled
  [env]
  http_proxy=your.proxy.here
  https_proxy=your.https.proxyhere

• please note spaces are not allowed before and after the string http_proxy
• restart the agent
• select the proper Proxy profile as in the image
• your agent will now work behind a proxy